Method: advertisers.lineItems.patch

既存の広告申込情報を更新します。成功した場合は、更新された広告申込情報を返します。

このエンドポイントへのリクエストは、同じ広告申込情報を更新する次のリクエストと同時に実行することはできません。

API を使用して YouTube とパートナーの広告申込情報を作成または更新することはできません。

この方法では、定期的に高いレイテンシが発生します。エラーを回避するために、デフォルトのタイムアウトを増やすことをおすすめします。

HTTP リクエスト

PATCH https://displayvideo.googleapis.com/v2/advertisers/{lineItem.advertiserId}/lineItems/{lineItem.lineItemId}

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
lineItem.advertiserId

string (int64 format)

出力のみ。広告申込情報が属する広告主の一意の ID。
lineItem.lineItemId

string (int64 format)

出力のみ。広告申込情報の一意の ID。システムによって割り当てられます。

クエリ パラメータ

パラメータ
updateMask

string (FieldMask format)

必須。更新するフィールドを制御するマスク。

これは、フィールドの完全修飾名のカンマ区切りリストです。（例: "user.displayName,photo"）。

リクエストの本文

リクエストの本文には LineItem のインスタンスが含まれています。

レスポンスの本文

成功した場合、レスポンスの本文には LineItem のインスタンスが含まれます。

承認スコープ

次の OAuth スコープが必要です。

  • https://www.googleapis.com/auth/display-video

詳細については、OAuth 2.0 の概要をご覧ください。