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 が生成した一意の ID のいずれかになります。

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 のお客様の場合)。

Address(住所)

顧客の住所の 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

顧客の住所としてリソースを識別する ID を指定します。値: 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 行で構成できます。addressline2addressLine3 は省略可能です。

organizationName

string

会社または会社の部門名。これは必須項目です。

contactName

string

お客様の連絡先の名前。これは必須項目です。

お客様タイプ

お客様のタイプ

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

メイン管理者

TEAM をご利用の場合のメイン管理者用 JSON テンプレート

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

string

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

メール確認リンクは、お客様の作成時にこのメールアドレスに送信されます。メイン管理者には顧客の管理コンソールへのアクセス権があり、これにはユーザーの招待と強制排除や、顧客の管理者ニーズの管理などがあります。

Methods

get

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

insert

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

patch

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

update

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