Method: customers.uploadUserData

上傳指定的使用者資料。

擲回錯誤清單：AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

HTTP 要求

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

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
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)

目標客戶比對使用者名單資料更新的中繼資料。

回應主體

在 Google Ads 使用者介面中，透過這項服務上傳的 UserDataService.UploadUserData 上傳作業，將不會顯示在 Google Ads 使用者介面中目標顧客比對名單的「區隔成員」部分下方。

如果成功，回應主體即會包含具有以下結構的資料：

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)

要從使用者名單中移除的使用者資料清單。