Method: customers.uploadUserData

指定されたユーザーデータをアップロードします。

スローされるエラーのリスト: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

HTTP リクエスト

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadUserData

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

パスパラメータ

パラメータ
customerId

string

必須。ユーザーデータを更新する顧客の ID。

リクエスト本文

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

JSON 表現 
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
フィールド
operations[]

object (UserDataOperation)

必須。実行するオペレーションのリスト。
共用体フィールド metadata。リクエストのメタデータ。metadata は次のいずれかになります。
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

カスタマー マッチのユーザーリストに対するデータ更新のメタデータ。

レスポンスの本文

このサービスを通じて行われた UserDataService.UploadUserData のアップロードに対するレスポンス メッセージは、Google 広告管理画面のカスタマー マッチ リストの [セグメントのメンバー] セクションに表示されません。

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
フィールド
uploadDateTime

string

API がリクエストを受信した日時。形式は「yyyy-mm-dd hh:mm:ss+|-hh:mm」です（例: 2019-01-01 12:32:45-08:00）。
receivedOperationsCount

integer

API が受信したアップロード データ オペレーションの数。

認可スコープ

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

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

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

UserDataOperation

UploadUserDataRequest に対して行われるオペレーション。

JSON 表現 
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
フィールド
共用体フィールド operation。UploadUserDataRequest に対して行われるオペレーション。operation は次のいずれかになります。
create

object (UserData)

ユーザーリストに追加するユーザーデータのリスト。
remove

object (UserData)

ユーザーリストから削除するユーザーデータのリスト。