Memesan akun pelanggan baru

Sebelum Anda membuat akun pelanggan baru, pertimbangkan hal berikut:

Membuat akun pelanggan

  1. Untuk membuat akun pelanggan, gunakan permintaan POST berikut dan sertakan token otorisasi:

    POST https://reseller.googleapis.com/apps/reseller/v1/customers

  2. Di akun pelanggan baru, membuat pengguna. Jika respons menampilkan kode status 409 Conflict HTTP, customerId sudah ada. Sebelum mendaftarkan akun pelanggan, Anda harus mentransfer langganan pelanggan.

  3. Jika berlaku, ubah bahasa default pelanggan.

  4. Promosikan ke peran administrator super. Saat membuat akun administrator, Anda dapat membuat {i>password<i} acak atau meminta pelanggan untuk memberikan {i>password<i}.

  5. Beri tahu pelanggan bahwa mereka harus login ke konsol Admin dan menandatangani perjanjian Google Workspace melalui Reseller untuk mengaktifkan akun mereka. Reseller dilarang menandatangani Persyaratan Layanan pada atas nama pelanggan.

Jenis pelanggan

Anda dapat membuat dua jenis pelanggan di Google Workspace:

  • Pelanggan yang diverifikasi domain. Para pelanggan ini membutuhkan Gmail dan perlu memiliki akses administrator penuh. Saat Anda membuat jenis pelanggan ini, tetapkan customerType hingga domain.
  • Pelanggan yang diverifikasi email. Pelanggan ini tidak memiliki atau mengelola {i>Directory<i} Saat Anda membuat jenis pelanggan ini, tetapkan customerType ke team. Jenis pelanggan ini dapat membeli Essentials dan Enterprise Essentials Google Workspace.

Isi permintaan JSON berikut adalah contoh pelanggan yang diverifikasi domain:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Ganti kode berikut:

  • DOMAIN_NAME: domain pelanggan Anda—misalnya, example.com
  • NAME: nama pelanggan Anda—misalnya, Alex Cruz.
  • ORGANIZATION_NAME: organisasi pelanggan Anda nama—misalnya, Example Organization.
  • POSTAL_CODE: kode pos pelanggan Anda—untuk contoh, 94043.
  • COUNTRY_CODE: 2 karakter pelanggan Anda Kode negara ISO.
  • EMAIL_ADDRESS: alamat email pelanggan Anda—untuk contoh, cruz@example.com.

Respons yang berhasil akan menampilkan kode status HTTP 200 dan kode status pelanggan baru informasi:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME",
  "customerType": "domain",
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Isi permintaan JSON berikut adalah contoh pelanggan yang diverifikasi email:

{
  "customerDomain": "DOMAIN_NAME",
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE"
  },
 "alternateEmail": "EMAIL_ADDRESS"
}

Respons yang berhasil akan menampilkan kode status HTTP 200 dan kode status pelanggan baru informasi:

{
  "kind": "reseller#customer",
  "customerId": "CUSTOMER_ID",
  "customerDomain": "DOMAIN_NAME,
  "customerType": "team",
  "primaryAdmin": {
    "primaryEmail": "EMAIL_ADDRESS"
  },
  "postalAddress": {
    "kind": "customers#address",
    "contactName": "NAME",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE",
    "countryCode": "COUNTRY_CODE",
  },
  "alternateEmail": "EMAIL_ADDRESS"
}

Mengubah bahasa default pelanggan

Bahasa default pelanggan hanya diterapkan ke pengguna baru saat mereka dibuat. Pengguna yang sudah ada tetap menggunakan bahasa mereka saat ini, bahkan setelah Anda mengubah bahasa default. Oleh karena itu, Anda harus menetapkan default pelanggan bahasa yang berbeda sebelum Anda membuat pengguna.

Pelanggan yang baru dibuat menggunakan bahasa default bahasa Inggris. Untuk mengubah bahasa default, gunakan PATCH atau UPDATE panggilan dari Directory API Pelanggan endpoint.

Gunakan Directory API untuk memperbarui nilai language default untuk pelanggan:

PATCH https://reseller.googleapis.com/admin/directory/v1/customers/CUSTOMER_ID

Sertakan isi permintaan JSON berikut:

{
  "language":"LANGUAGE_CODE"
}

Ganti kode berikut:

  • CUSTOMER_ID: ID unik untuk pelanggan—misalnya, C0123456
  • LANGUAGE_CODE: diterima kode bahasa —misalnya, es untuk bahasa Spanyol.

Respons JSON yang berhasil akan menampilkan kode status HTTP 200 dan kode status terbaru referensi pelanggan:

{
  "alternateEmail": "EMAIL_ADDRESS",
  "customerCreationTime": "2022-12-12T23:04:10.620Z",
  "customerDomain": "DOMAIN_NAME",
  "id": "CUSTOMER_ID",
  "kind": "admin#directory#customer",
  "language": "LANGUAGE_CODE",
  "postalAddress": {
    "contactName": "NAME",
    "countryCode": "COUNTRY_CODE",
    "organizationName": "ORGANIZATION_NAME",
    "postalCode": "POSTAL_CODE"
  }
}

Langkah berikutnya