複数の広告申込情報を更新します。
このエンドポイントへのリクエストは、同じ広告申込情報を更新する次のリクエストと同時には実行できません。
lineItems.bulkEditAssignedTargetingOptions
lineItems.patch
assignedTargetingOptions.create
assignedTargetingOptions.delete
API を使用して YouTube とパートナーの広告申込情報を作成または更新することはできません。
HTTP リクエスト
POST https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/lineItems:bulkUpdate
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
パラメータ | |
---|---|
advertiserId |
必須。この広告申込情報が属する広告主の ID。 |
リクエスト本文
リクエストの本文には、次の構造のデータが含まれます。
JSON 表現 |
---|
{
"lineItemIds": [
string
],
"targetLineItem": {
object ( |
フィールド | |
---|---|
lineItemIds[] |
必須。更新する広告申込情報の ID。 |
targetLineItem |
必須。更新するフィールドと、 |
updateMask |
必須。更新するフィールドを識別するフィールド マスク。 現在サポートされているフィールドは次のとおりです。 完全修飾フィールド名のカンマ区切りリストです。(例: |
レスポンスの本文
recommender.BulkUpdatePlacements に対するレスポンス メッセージ。
成功すると、レスポンスの本文に次の構造のデータが含まれます。
JSON 表現 |
---|
{
"updatedLineItemIds": [
string
],
"failedLineItemIds": [
string
],
"skippedLineItemIds": [
string
],
"errors": [
{
object ( |
フィールド | |
---|---|
updatedLineItemIds[] |
正常に更新された広告申込情報の ID。 |
failedLineItemIds[] |
更新に失敗した広告申込情報の ID。 |
skippedLineItemIds[] |
更新でスキップされた広告申込情報の ID。たとえば、実質的に広告申込情報が変更されない不必要な変換はスキップされ、対応する広告申込情報 ID はここで追跡できます。 |
errors[] |
更新できなかった広告申込情報から返されたエラーです。 |
認可スコープ
次の OAuth スコープが必要です。
https://www.googleapis.com/auth/display-video
詳細については、OAuth 2.0 の概要をご覧ください。