REST Resource: customers

リソース: Customer

Google のお客様のアカウントが販売パートナーに登録されている場合、そのお客様の Google サービスのサブスクリプションは、この販売パートナーによって管理されます。顧客は、プライマリ ドメイン名と物理的なアドレスで記述されます。

JSON 表現 
{
  "customerId": string,
  "customerDomain": string,
  "postalAddress": {
    object (Address)
  },
  "phoneNumber": string,
  "alternateEmail": string,
  "resourceUiUrl": string,
  "customerDomainVerified": boolean,
  "kind": string,
  "customerType": enum (CustomerType),
  "primaryAdmin": {
    object (PrimaryAdmin)
  }
}
フィールド
customerId

string

このプロパティは、常に Google が生成した一意の識別子としてレスポンスで返されます。リクエストでは、このプロパティはプライマリ ドメインか、Google によって生成された一意の識別子のいずれかになります。
customerDomain

string

顧客のプライマリ ドメイン名の文字列。新規顧客を作成するには、customerDomain が必要です。お客様を追加するときは、ドメインに www の接頭辞を含めないでください。
postalAddress

object (Address)

顧客の住所情報。各フィールドの最大文字数は 255 文字です。
phoneNumber

string

お客様の連絡先の電話番号。「+」で始まる必要がありますその後に国コードを続けます。残りの番号は連続した番号にすることも、地域の電話番号の形式に準拠することもできますが、実際の電話番号（「123」など）は使用できません。無効な場合、このフィールドは通知なく無視されます。
alternateEmail

string

[顧客のメールアドレス] など販売代理店用ツールでは、このメールアドレスが予備の連絡先になります。サービスの停止やセキュリティの問題など、お客様のサービスに問題が発生した場合に使用されます。新しい「ドメイン」を作成する場合、このプロパティは必須ですcustomerDomain と同じドメインは使用しないでください。「チーム」の作成に alternateEmail フィールドは必要ありません提供します。
resourceUiUrl

string

顧客の管理コンソール ダッシュボードへの URL。読み取り専用 URL は API サービスによって生成されます。これは、クライアント アプリケーションで顧客が管理コンソールでタスクを完了する必要がある場合に使用します。
customerDomainVerified

boolean

お客様のプライマリ ドメインの所有権が証明されているかどうか。
kind

string

リソースを顧客として識別します。値: reseller#customer
customerType

enum (CustomerType)

顧客のタイプを識別します。指定できる値は次のとおりです。

  • domain: ドメインの所有権を証明済みのお客様を表します（デフォルト）。
  • team: メールによる確認済みの顧客を表します。

詳しくは、マネージド チームをご覧ください。
primaryAdmin

object (PrimaryAdmin)

お客様の最初の管理者の詳細情報（TEAM のお客様の場合）。

住所

顧客の住所の JSON テンプレート。

JSON 表現 
{
  "countryCode": string,
  "kind": string,
  "region": string,
  "addressLine2": string,
  "locality": string,
  "addressLine3": string,
  "postalCode": string,
  "addressLine1": string,
  "organizationName": string,
  "contactName": string
}
フィールド
countryCode

string

countryCode について詳しくは、ISO 3166 国コード要素をご覧ください。Google プロダクトの再販が承認されている国であることを確認します。このプロパティは、新しい顧客を作成する場合には必須です。
kind

string

リソースを顧客の住所として識別します。値: customers#address
region

string

region の値の例としては、カリフォルニア州の場合は CA が挙げられます。
addressLine2

string

住所の 2 行目。
locality

string

locality 値の例は San Francisco の都市です。
addressLine3

string

住所の 3 行目。
postalCode

string

postalCode は郵便番号の例（94043 など）です。このプロパティは、新しい顧客を作成する場合には必須です。
addressLine1

string

顧客の実際の住所。住所は 1 行から 3 行で構成されます。addressline2 と addressLine3 は省略可能です。
organizationName

string

会社名または会社の部門名。必須入力項目です。
contactName

string

お客様の連絡先の名前。必須入力項目です。

CustomerType

お客様のタイプ

列挙型
customerTypeUnspecified 顧客タイプが不明です
domain ドメインまたはドメインを所有しているお客様
team ドメインレスまたはメール確認済みのお客様

PrimaryAdmin

TEAM のお客様の場合、メイン管理者用の JSON テンプレート

JSON 表現 
{
  "primaryEmail": string
}
フィールド
primaryEmail

string

顧客のメイン管理者のビジネス用メールアドレス。

メール確認リンクは、顧客の作成時にこのメールアドレスに送信されます。メイン管理者はお客様の管理コンソールにアクセスして、ユーザーを招待および強制排除したり、お客様の管理業務を管理したりする権限があります。

メソッド

get

 顧客アカウントを取得します。

insert

 新規顧客のアカウントを注文します。

patch

 顧客アカウントの設定を更新します。

update

 顧客アカウントの設定を更新します。