更新客戶管理員連結。系統會傳回作業狀態。
擲回錯誤清單:AuthenticationError AuthorizationError DatabaseError FieldError FieldMaskError HeaderError InternalError ManagerLinkError MutateError QuotaError RequestError
HTTP 要求
POST https://googleads.googleapis.com/v16/customers/{customerId}/customerManagerLinks:mutate
這個網址使用 gRPC 轉碼語法。
路徑參數
參數 | |
---|---|
customerId |
必要欄位。要修改客戶管理員連結的客戶 ID。 |
要求主體
要求主體的資料會採用以下結構:
JSON 表示法 |
---|
{
"operations": [
{
object ( |
欄位 | |
---|---|
operations[] |
必要欄位。對個別客戶管理員連結執行的作業清單。 |
validateOnly |
如果為 true,表示要求會完成驗證,但尚未執行。系統只會傳回錯誤,不會傳回結果。 |
回應主體
CustomerManagerLink 變更的回應訊息。
如果成功,回應主體即會包含具有以下結構的資料:
JSON 表示法 |
---|
{
"results": [
{
object ( |
欄位 | |
---|---|
results[] |
結果,用來識別受 修改要求影響的資源。 |
授權範圍
需要下列 OAuth 範圍:
https://www.googleapis.com/auth/adwords
詳情請參閱 OAuth 2.0 總覽。
CustomerManagerLinkOperation
更新 CustomerManagerLink 的狀態。可能的動作如下:1. 狀態為「ACTIVE」(啟用) 的更新作業,接受待處理的邀請。2. 狀態為 REFUSED 的更新作業拒絕待處理邀請。3. 狀態為「INACTIVE」的更新作業會終止與管理員的連結。
JSON 表示法 |
---|
{ "updateMask": string, // Union field |
欄位 | |
---|---|
updateMask |
FieldMask,用於決定更新中要修改哪些資源欄位。 此為以半形逗號分隔的完整欄位名稱清單,範例: |
聯集欄位 operation 。修改作業。operation 只能是下列其中一項: |
|
update |
更新作業:連結應具備有效的資源名稱。 |
MutateCustomerManagerLinkResult
客戶管理員連結的結果有所變更。
JSON 表示法 |
---|
{ "resourceName": string } |
欄位 | |
---|---|
resourceName |
如果作業成功,系統會傳回。 |