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)

お客様の最初の管理者の詳細(チームのお客様の場合)。

住所

お客様の住所の 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 行で構成できます。addressline2addressLine3 は省略可能です。

organizationName

string

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

contactName

string

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

CustomerType

お客様のタイプ

列挙型
customerTypeUnspecified 顧客タイプ不明
domain ドメイン所有またはドメイン所有権証明済みのお客様
team ドメインなしまたはメールアドレス所有権確認済みのお客様

PrimaryAdmin

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

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

string

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

メール確認リンクは、お客様の作成時にこのメールアドレスに送信されます。メイン管理者は、お客様の管理コンソールにアクセスできます。管理コンソールでは、ユーザーの招待や強制退去、お客様の管理ニーズを管理できます。

メソッド

get

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

insert

新しいお客様のアカウントを注文します。

patch

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

update

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