Method: customers.createCustomerClient

在「管理員」下建立新客戶。系統將傳回這個新客戶的客戶。

擲回錯誤清單:AccessInvitationError AuthenticationError AuthorizationError CurrencyCodeError HeaderError InternalError ManagerLinkError QuotaError RequestError StringLengthError TimeZoneError

HTTP 要求

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

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

路徑參數

參數
customerId

string

必要欄位。為哪個管理員建立客戶 ID。

要求主體

要求主體的資料會採用以下結構:

JSON 表示法
{
  "customerClient": {
    object (Customer)
  },
  "accessRole": enum (AccessRole),
  "validateOnly": boolean,
  "emailAddress": string
}
欄位
customerClient

object (Customer)

必要欄位。要建立的新客戶。系統會忽略這個客戶的資源名稱。

accessRole

enum (AccessRole)

在已建立的客戶客戶上提議的使用者角色。僅限許可清單中的客戶存取。

validateOnly

boolean

如果為 true,則驗證要求但尚未執行。系統只會傳回錯誤,而非傳回結果。

emailAddress

string

負責邀請已建立客戶客戶的使用者電子郵件地址。僅限許可清單中的客戶存取。

回應主體

customer.createCustomerClient 變更的回應訊息。

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

JSON 表示法
{
  "resourceName": string,
  "invitationLink": string
}
欄位
resourceName

string

新建客戶的資源名稱。客戶資源名稱的格式為:customers/{customerId}

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/adwords

詳情請參閱 OAuth 2.0 總覽