建立或移除客戶素材資源組合。系統會傳回作業狀態。
HTTP 要求
POST https://googleads.googleapis.com/v17/customers/{customerId}/customerAssetSets:mutate
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
必要欄位。要修改客戶素材資源組合的客戶 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{ "operations": [ { object ( |
欄位 | |
---|---|
operations[] |
必要欄位。針對個別客戶素材資源組合執行的作業清單。 |
partialFailure |
如為 true,則會執行成功的作業,且執行無效作業會傳回錯誤。如果設為 False,則所有作業都必須是有效狀態,才會在單一交易中進行。預設值為 false。 |
validateOnly |
如果為 true,表示請求已經驗證,但不會執行。系統只會傳回錯誤,不會傳回結果。 |
responseContentType |
回應內容類型設定。決定是否應在異動後傳回可變動資源或僅傳回資源名稱。 |
回應主體
客戶素材資源組合 Mu 的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{ "results": [ { object ( |
欄位 | |
---|---|
results[] |
所有與 變更 相關的結果。 |
partialFailureError |
與部分失敗模式下作業失敗相關的錯誤。只有在部分失敗 = 是 true,且作業中出現所有錯誤時,才會傳回這個引數。如果作業之外發生任何錯誤 (例如驗證錯誤),則會傳回遠端程序呼叫 (RPC) 層級錯誤。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
CustomerAssetSetOperation
對客戶素材資源集執行一項操作 (建立、移除)。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 operation 。更改作業。operation 只能是下列其中一項: |
|
create |
建立作業:新客戶資產集不需要有資源名稱。 |
remove |
移除作業:已移除客戶素材資源集的資源名稱,格式如下: |
MutateCustomerAssetSetResult
客戶素材資源組合 change 的結果。
JSON 表示法 |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
欄位 | |
---|---|
resourceName |
如果作業成功,系統會傳回這個值。 |
customerAssetSet |
已變動客戶素材資源組合,在 變更 之後只有可變動的欄位。只有在 responseContentType 設為「MUTABLE_RESOURCE」時,才會傳回此欄位。 |