一般的なエラーメッセージ
| ステータス | 名前 | メッセージ | 原因 |
|---|---|---|---|
| 400 | BAD_REQUEST |
ILLEGAL_PATH：10本を超える動画のリクエストはサポートされていません | 基本GET /videos/video_idsリクエストで10本を超える動画をリクエストすることはできません |
| 400 | INVALID_SORT |
無効なプロパティで並べ替えようとしました： '[プロパティ名]' | ザ・sort無効または存在しないフィールドを指すパラメータ |
| 400 | INVALID_SEARCH |
検索文字列が無効でした | 検索文字列の構文が無効であるか、検索文字列のURIエンコードに失敗しました |
| 400 | ILLEGAL_QUERY |
クエリ文字列に問題がありました | 検索文字列の構文が無効でした-例：1）tagsカンマで終わるか、引用符が閉じられていない検索 |
| 400 | BAD_VALUE |
送信されたデータの認識されないフィールド | スペルミス、または存在しないフィールドのその他の使用 |
| 400 | AD_CONFIG_NOT_FOUND |
広告設定が見つかりません | SSAI リクエストで指定された広告設定が見つかりませんでした |
| 400 | AD_CONFIG_INACTIVE |
広告設定は非アクティブです | SSAI リクエストで指定された広告構成は非アクティブです |
| 400 | REFERENCES_EXIST |
この動画は、少なくとも1つの再生リストから参照されています。 | 少なくとも1つの再生リストに含まれている動画を削除しようとしています。 |
| 400 | SHARED_VIDEO |
共有動画の削除に失敗しました。 | 共有動画の削除はまだサポートされていません。 |
| 401 | UNAUTHORIZED |
アクセス拒否。 | OAuth アクセストークンがないか無効です。アクセストークンを指定した場合は、このリクエストに適切なスコープがない可能性があります |
| 403 | NOT_AVAILABLE |
リソースが利用できません。 | 要求しているリソースは一時的に利用できません。これは、ビデオの処理が進行中の一時的な状態である可能性がありますが、メッセージが続く場合は、サポートに連絡してください。 |
| 404 | NOT_FOUND |
リソースが存在しません。 | 存在しないリソースをリクエストしました-スペルを確認してください。 |
| 405 | METHOD_NOT_ALLOWED |
リクエストに使用されるHTTPメソッドは、このリソースでは許可されていません | 最も一般的な原因は、PUT、POST、PATCH、またはDELETEを読み取り専用リソースに送信することです。 |
| 406 | NOT_ACCEPTABLE |
HTTPAcceptヘッダーに許可されていない値があります。 | ザ・Acceptヘッダーには値が必要ですapplication/json ;などの他の値 application/x-www-form-urlencodedこのエラーでリクエストが拒否されます。 |
| 409 | LIVE_VIDEOS_NOT_SHAREABLE |
この動画はライブであるため共有できません。 | それらから作成されたライブストリーミングビデオとクリップは共有できません。 |
| 409 | REFERENCE_ID_IN_USE |
参照IDはすでに使用されています。 | すでに使用されている参照IDを使用してビデオを作成しようとしたか、別のビデオですでに使用されているビデオに参照IDを追加しようとしました。 |
| 409 | CONCURRENT_UPDATE |
同時に別の更新が行われたため、更新に失敗しました。もう一度やり直してください。 | 別のAPIリクエスト、Studioユーザー、または何らかのシステムプロセスが現在動画を更新しています。これは、同じ動画でAPI更新リクエストを非同期で連続して行う場合にも発生する可能性があります。 |
| 409 | CONFLICT |
参照IDはすでに使用されています。 | 参照IDの一意性を保証するために、参照IDを含む操作では、最大3分間IDがロックされます。つまり、参照IDを作成または変更する要求を行った後、その参照IDを使用する他の要求をすぐに行うと、操作は409エラーで失敗します。これには次のものが含まれます。1）ビデオを削除してから、その参照IDを別のビデオに割り当てようとします。 2）503（サービスを利用できません）エラーで失敗する新しいビデオを作成しようとし、同じリクエストを再試行します。
このエラーが発生してから少なくとも3分待ってから、操作を再試行してください。参照 ID を使用してビデオを作成しようとしたときに、（参照 ID とは無関係な理由で）失敗した場合、その参照 ID は 30 秒間ロックされ、参照 ID のロックが解除されるまでビデオの作成を繰り返し試行できません。 |
| 409 | CONFLICT |
メディア共有を有効にするには、両方のアカウントを有効にする必要があります。 | マスターアカウントがメディア共有のためにアフィリエイトアカウントをチャネルに追加しようとすると、 どちらも アカウントでメディア共有を有効にする必要があります。 |
| 409 | UNSUPPORTED_MEDIA_TYPE |
リクエストにヘッダーがない可能性があります。Content-Type: application/json。 |
|
| 415 | SHARING_DISABLED |
マスターアカウントでメディア共有が有効になっていません。 | メディア共有が有効になっていないアカウントからビデオを共有しようとすると、このエラーが返されます。 |
| 422 | ILLEGAL_FIELD |
送信されたデータの認識されないフィールド | スペルミス、または存在しないフィールドのその他の使用 |
| 422 | VALIDATION_ERROR |
（JSONデータは無効でした-エラーメッセージは問題によって異なります） | メッセージの例：
|
| 429 | TOO_MANY_REQUESTS |
リクエストが多すぎます | 同時に送信するリクエストが多すぎるか、1秒あたりのリクエストが多すぎます |
| 500 | UNKNOWN |
不明な内部エラーが発生しました | Brightcoveシステムの問題-後でもう一度お試しください。 |
| 503 | SERVICE_UNAVAILABLE |
APIは一時的に利用できません | バックエンドの問題-後でもう一度試してください。 |
| 504 | TIMEOUT |
何か時間がかかりすぎた | サーバーがビジー状態である可能性があります-後でもう一度試してください。 |
メディア共有エラー
メディア共有エラーは、API リクエストに対する個別のエラー応答として返されるのではなく、error_message通常の応答のフィールドに返されます。
[
{
"video_id" : "394872349182374",
"affiliate_id" : "234987239487",
"affiliate_video_id" : "30308254055202",
"status" : "COMPLETE",
"shared_at" : "2017-12-11T17:57:45.530Z",
"updated_at" : "2017-12-11T18:03:32.789Z",
"error_message" : "[{"error_code":"MISSING_CUSTOM_FIELDS","error_message":"Affiliate account is missing custom fields: [whisky]"}]"
}
]
ザ・error_message jsonはエラーオブジェクトの配列になり、オブジェクトはerror_codeそしてerror_message。
error_code
エラーコードは通常、共有固有ですが、ビデオのPATCH（更新）操作によって返される有効なエラーコードのいずれかである可能性があります。共有固有のエラーコードを次の表に示します。
error_code |
エラーメッセージ | 原因 |
|---|---|---|
MISSING_CUSTOM_FIELDS |
アフィリエイトアカウントにカスタムフィールドがありません：[field1、field2] | マスターが設定しましたenforce_custom_fieldsにtrue、ただし、共有されているビデオは、アフィリエイトアカウントに存在しないフィールドを参照しています。 |
CONFLICT |
アフィリエイトアカウントは地理的制限用に構成されていません。 | マスターのenforce_geoがtrueに設定されており、そのアカウントは地理フィルタリング用に構成されていますが、アフィリエイトアカウントは地理フィルタリング用に構成されていません。 |
SHARING_DISABLED |
アフィリエイトアカウントはメディア共有に対して有効になっていません。 | マスターが、メディア共有が有効になっていないアフィリエイトとビデオを共有しようとしました。 |
NOT_FOUND |
リソースが存在しません。 | 何かが足りませんでした。通常、これはマスタービデオがなくなったことを意味します。マスター動画を削除した後、直ちに共有要求を行うと、発生する場合があります。これは、マスターアカウントにまだチャネルがない場合、またはアフィリエイトアカウントが存在しないか、チャネルの有効なメンバーではない場合もあります。これは、への移行で問題が発生した場合に発生する可能性がありますCMS APIメディア共有。 |
UNKNOWN |
不明なエラーerror_idINSERT-UNIQUE-ERROR-IDで共有に失敗しました | 予期しないことが起こりました。error_messageには、根本的な原因を特定するためにdevopsが使用できるエラーIDが含まれます。多くの場合、共有の試行を再試行すると機能します。 |
VALIDATION_ERROR |
{field}：ILLEGAL_VALUE | もしも{field}が「経済学」である場合、問題はマスタービデオが「広告サポート」されているが、アフィリエイトアカウントで広告が有効になっていないことです。アカウントが広告に対して無効になっているときに、（非共有ビデオの）ビデオメタデータでサポートされている広告に広告を設定した場合にも発生します。もしも{field}それ以外の場合は、調査が必要です。 |
REFERENCE_ID_IN_USE |
使用したものは何でも参照IDはすでに使用されています。 | 参照IDはマスターアカウントで有効でしたが、アフィリエイトアカウントですでに使用されています。 |