Method: customers.createCustomerClient

以管理員名義建立新客戶。系統會傳回新客戶。

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

HTTP 要求

POST https://googleads.googleapis.com/v16/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 mut 的回應訊息。

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

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

string

新建客戶的資源名稱。客戶資源名稱的格式如下：customers/{customerId}。

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。