在離線使用者資料工作中新增作業。
擲回錯誤清單:AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError
HTTP 要求
POST https://googleads.googleapis.com/v16/{resourceName=customers/*/offlineUserDataJobs/*}:addOperations
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
resourceName |
必要欄位。OfflineUserDataJob 的資源名稱。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"operations": [
{
object ( |
欄位 | |
---|---|
operations[] |
必要欄位。要處理的作業清單。 |
validateOnly |
如果為 true,表示要求會完成驗證,但尚未執行。系統只會傳回錯誤,不會傳回結果。 |
enablePartialFailure |
True 表示為離線使用者資料工作啟用部分失敗功能。 |
enableWarnings |
True 表示啟用離線使用者資料工作的警告。啟用後,警告不會封鎖 OfflineUserDataJobOperation,也會傳回欄位值格式錯誤相關的警告訊息。 |
回應主體
「OfflineUserDataJobService.AddOfflineUserDataJobOperations
」的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "partialFailureError": { object ( |
欄位 | |
---|---|
partialFailureError |
部分失敗模式下的作業失敗相關錯誤。只有在部分失敗 = true 且所有錯誤發生於作業內部時,才會傳回這個值。如果在作業之外發生任何錯誤 (例如驗證錯誤),系統會傳回遠端程序呼叫 (RPC) 層級錯誤。 |
warning |
警告模式中與作業失敗相關的非封鎖錯誤。只有在 enableWarnings = true 時,才會傳回這個字串。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
OfflineUserDataJobOperation
要針對 AddOfflineUserDataJobOperationsRequest 執行的作業。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 operation 。要針對 AddOfflineUserDataJobOperationsRequest 執行的作業。operation 只能是下列其中一項: |
|
create |
將提供的資料新增至交易。上傳後無法擷取資料。 |
remove |
從交易中移除提供的資料。上傳後無法擷取資料。 |
removeAll |
移除所有先前提供的資料。這只適用於目標顧客比對。 |