Method: customers.customInterests.mutate

カスタム インタレストの作成または更新。オペレーションのステータスが返されます。

スローされるエラーのリスト: AuthenticationError AuthorizationError CriterionError CustomInterestError HeaderError InternalError MutateError PolicyViolationError QuotaError RequestError StringLengthError

HTTP リクエスト

POST https://googleads.googleapis.com/v16/customers/{customerId}/customInterests:mutate

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

パスパラメータ

パラメータ
customerId

string

必須。カスタム インタレストを変更するユーザーの ID。

リクエスト本文

リクエストの本文には、次の構造のデータが含まれます。

JSON 表現 
{
  "operations": [
    {
      object (CustomInterestOperation)
    }
  ],
  "validateOnly": boolean
}
フィールド
operations[]

object (CustomInterestOperation)

必須。個々のカスタム インタレストに対して実行するオペレーションのリストです。
validateOnly

boolean

true の場合、リクエストは検証されますが実行されません。結果ではなく、エラーのみが返されます。

レスポンスの本文

カスタム インタレストの変換に対するレスポンス メッセージ。

成功した場合、レスポンスの本文には次の構造のデータが含まれます。

JSON 表現 
{
  "results": [
    {
      object (MutateCustomInterestResult)
    }
  ]
}
フィールド
results[]

object (MutateCustomInterestResult)

変換のすべての結果。

認可スコープ

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

  • https://www.googleapis.com/auth/adwords

詳しくは、OAuth 2.0 の概要をご覧ください。

CustomInterestOperation

カスタム インタレストに対する単一のオペレーション（作成、更新）。

JSON 表現 
{
  "updateMask": string,

  // Union field operation can be only one of the following:
  "create": {
    object (CustomInterest)
  },
  "update": {
    object (CustomInterest)
  }
  // End of list of possible types for union field operation.
}
フィールド
updateMask

string (FieldMask format)

更新で変更されるリソース フィールドを決定する FieldMask。

完全修飾フィールド名のカンマ区切りリスト。例: "user.displayName,photo"。
共用体フィールド operation。変更オペレーション。operation は次のいずれかになります。
create

object (CustomInterest)

作成オペレーション: 新しいカスタム インタレストにリソース名は必要ありません。
update

object (CustomInterest)

更新オペレーション: カスタム インタレストには有効なリソース名が必要です。

MutateCustomInterestResult

カスタム インタレスト ミューテーションの結果。

JSON 表現 
{
  "resourceName": string
}
フィールド
resourceName

string

オペレーションが成功すると返されます。