Method: advertisers.lineItems.patch

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

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

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

この方法では、通常、レイテンシが高くなります。エラーを回避するため、デフォルトのタイムアウトを長くすることをおすすめします。

HTTP リクエスト

PATCH https://displayvideo.googleapis.com/v3/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 の概要をご覧ください。