上傳指定的使用者資料。
擲回錯誤清單:AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError
HTTP 要求
POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadUserData
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
必要欄位。要更新使用者資料的客戶 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "operations": [ { object ( |
欄位 | |
---|---|
operations[] |
必要欄位。要完成的作業清單。 |
聯集欄位 metadata 。要求的中繼資料。metadata 只能是下列其中一項: |
|
customerMatchUserListMetadata |
目標客戶比對使用者名單資料更新的中繼資料。 |
回應主體
在 Google Ads 使用者介面中,透過這項服務上傳的 UserDataService.UploadUserData
上傳作業,將不會顯示在 Google Ads 使用者介面中目標顧客比對名單的「區隔成員」部分下方。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "uploadDateTime": string, "receivedOperationsCount": integer } |
欄位 | |
---|---|
uploadDateTime |
API 收到要求的日期時間,格式為「yyyy-mm-dd hh:mm:ss+|-hh:mm」,例如「2019-01-01 12:32:45-08:00」。 |
receivedOperationsCount |
API 收到的上傳資料作業數量。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
UserDataOperation
即將針對 UploadUserDataRequest 進行的作業。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 operation 。即將針對 UploadUserDataRequest 進行的作業。operation 只能是下列其中一項: |
|
create |
要附加到使用者名單的使用者資料清單。 |
remove |
要從使用者名單中移除的使用者資料清單。 |