広告申込情報を CSV 形式でアップロードします。YouTube とパートナーの広告申込情報はサポートされていません。 実習をご覧ください。
リクエスト
HTTP リクエスト
POST https://www.googleapis.com/doubleclickbidmanager/v1.1/lineitems/uploadlineitems
承認
このリクエストには、次のスコープによる認証が必要です。
範囲 |
---|
https://www.googleapis.com/auth/doubleclickbidmanager |
詳細については、認証と承認のページをご覧ください。
リクエスト本文
リクエストの本文には、以下の構造を使用してデータを指定してください。
{ "lineItems": string, "format": string, "dryRun": boolean }
プロパティ名 | 値 | 説明 | 備考 |
---|---|---|---|
lineItems |
string |
CSV でアップロードする広告申込情報。ファイル形式の詳細については、エンティティ書き込みファイル形式をご覧ください。 | |
format |
string |
広告申込情報のフォーマットを指定します。デフォルトは CSV です。有効な値は次のとおりです。
|
|
dryRun |
boolean |
広告申込情報を実際に保持せずに true に設定すると、アップロード ステータスを取得できます。 |
レスポンス
成功すると、このメソッドは次の構造を含むレスポンスの本文を返します。
{ "uploadStatus": { "errors": [ string ], "rowStatus": [ { "rowNumber": integer, "entityId": long, "entityName": string, "changed": boolean, "persisted": boolean, "errors": [ string ] } ] } }
プロパティ名 | 値 | 説明 | 備考 |
---|---|---|---|
uploadStatus |
nested object |
アップロードのステータス。 | |
uploadStatus.errors[] |
list |
アップロードを完了できない理由です。 | |
uploadStatus.rowStatus[] |
list |
行ごとのアップロード ステータス。 | |
uploadStatus.rowStatus[].rowNumber |
integer |
行番号。 | |
uploadStatus.rowStatus[].entityId |
long |
エンティティ ID。 | |
uploadStatus.rowStatus[].entityName |
string |
Entity name(エンティティ名)。 | |
uploadStatus.rowStatus[].changed |
boolean |
アップロードの結果として、保存されたエンティティが変更されたかどうかを示します。 | |
uploadStatus.rowStatus[].persisted |
boolean |
エンティティが永続化されているかどうか。 | |
uploadStatus.rowStatus[].errors[] |
list |
エンティティをアップロードできない理由。 |
実習
以下の API Explorer を使用して、ライブデータでこのメソッドを呼び出し、レスポンスを確認します。 または、スタンドアロンの Explorer をお試しください。