Mengelola hak Google Workspace dan Google Chrome

Halaman ini menjelaskan cara mengelola hak pelanggan untuk produk Google Workspace dan Google Chrome.

Prasyarat

Sebelum melanjutkan, tentukan apakah akun reseller Anda memiliki satu akun penagihan Google Workspace atau beberapa akun penagihan Google Workspace. Untuk mempelajari topik ini lebih lanjut, baca Panduan Memulai Beberapa Akun Penagihan Google Workspace .

Buat hak

Sebelum memulai

Anda memerlukan penyiapan Customer sebelum dapat melanjutkan.

Untuk membuat hak, ikuti langkah-langkah berikut:

Dengan nama Pelanggan, panggil listPurchasableSkus untuk mengambil daftar PurchasableSkus

ListPurchasableSkusRequest
{
  "customer": "accounts/123/customers/abc",
  "createEntitlementPurchase": {
    "product": "products/-"
  }
}
ListPurchasableSkusResponse
{
  "purchasableSkus": [
    {
      "sku": {
        "name": "products/product_id/skus/sku_id1",
        "product": {
          "name": "products/product_id",
        }
      }
    },
    {
      "sku": {
        "name": "products/product_id/skus/sku_id2",
        "product": {
          "name": "products/product_id",
        },
      }
    }
  ]
}

Dengan PurchasableSku yang dipilih, gunakan metode queryEligibleBillingAccounts untuk menemukan kumpulan Google Workspace BillingAccount yang dapat digunakan untuk membayar hak.

Jika Anda ingin membayar dengan mata uang tertentu, pilih BillingAccount dengan mata uang tersebut.

QueryEligibleBillingAccountsRequest
{
  "customer": "accounts/123/customers/abc",
  "skus": ["products/product_id/skus/sku_id1"]
}
QueryEligibleBillingAccountsResponse
{
  "skuPurchaseGroups": [
    {
      "skus": [
        "products/product_id/skus/sku_id1"
      ],
      "billingAccountPurchaseInfos": [
        {
          "billingAccount": {
            "name": "accounts/123/billingAccounts/billing_account_id1",
            "displayName": "Google_Workspace_USD_US_1",
            "currencyCode": "USD",
            "regionCode": "US"
          }
        },
        {
          "billingAccount": {
            "name": "accounts/123/billingAccounts/billing_account_id2",
            "displayName": "Google_Workspace_CAD_CA_1",
            "currencyCode": "CAD",
            "regionCode": "CA"
          }
        }
      ]
    }
  ]
}

Dengan PurchasableSku dan BillingAccount yang dipilih, gunakan metode listPurchasableOffers untuk menemukan PurchasableOffer yang tersedia

ListPurchasableOffersRequest
{
  "customer": "accounts/123/customers/abc",
  "createEntitlementPurchase": {
    "sku": "products/product_id/skus/sku_id1",
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
ListPurchasableOffersResponse
{
  "purchasableOffers": [
    {
      "offer": {
        "name": "accounts/123/offers/offer_id1",
      },
      "sku": {
        "name": "products/product_id/skus/sku_id1",
      },
      "plan": {
        "paymentPlan": "FLEXIBLE",
        "paymentCycle": {
          "duration": 1,
          "periodType": "MONTH"
        }
      },
    }
  ],
}

Pada tahap ini, Anda harus memiliki BillingAccount yang akan membayar Entitlement dan PurchasableOffer. Mulai buat hak menggunakan metode create.

Buat Hak dan isi penawaran, billingAccount, dan parameter lain yang diperlukan.

CreateEntitlementRequest
{
  "parent": "accounts/123/customers/abc",
  "entitlement": {
    "offer": "accounts/123/offers/offer_id1",
    "maxUnits": 100,
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
CreateEntitlementResponse
{
  "name": "operations/operation_id1"
}

Mengubah paket pembayaran untuk hak Google Workspace

Sebelum memulai

Hak Google Workspace dengan pembayaran Gratis atau Uji Coba plan tidak memiliki akun penagihan Google Workspace. Untuk mengubah paket pembayaran Entitlement menjadi paket pembayaran berbayar, ada beberapa langkah tambahan untuk memilih akun penagihan Google Workspace.

Untuk mengubah paket pembayaran atas hak Google Workspace, ikuti langkah-langkah berikut:

Dua langkah pertama hanya diperlukan jika Hak yang ada memiliki paket pembayaran Gratis atau Uji Coba.

Dengan Penawaran, gunakan metode lookupOffer untuk menemukan informasi Sku mengenai Penawaran.

LookupOfferRequest
{
  "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1"
}
LookupOffer respones
{
  "name": "accounts/123/offers/offer_id1",
  "sku": {
    "name": "products/product_id/skus/sku_id1",
   }
}

Dengan Pelanggan dan SKU, gunakan metode queryEligibleBillingAccounts untuk menemukan kumpulan BillingAccount yang dapat digunakan untuk membayar Hak ini. Jika Anda ingin membayar dengan mata uang tertentu, pilih Akun Penagihan dengan mata uang tersebut.

 QueryEligibleBillingAccountsRequest
 {
   "customer": "accounts/123/customers/abc",
   "skus": ["products/product_id/skus/sku_id1"]
 }
 QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

Dengan Entitlement dan BillingAccount, gunakan metode listPurchasableOffers untuk menemukan PurchasableOffer. BillingAccount tidak diperlukan jika hak yang ada sudah memiliki paket berbayar, dalam hal ini, BillingAccount yang ada akan digunakan. Untuk mengubah paket pembayaran, kolom purchase_option harus menjadi changeOfferPurchase

ListPurchasableOffersRequest
{
  "customer": "accounts/123/customers/abc",
  "changeOfferPurchase": {
    "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
  }
}
ListPurchasableOffersResponse
{
  "purchasableOffers": [
    {
      "offer": {
        "name": "accounts/123/offers/offer_id1",
      },
      "sku": {
        "name": "products/product_id/skus/sku_id1",
      },
      "plan": {
        "paymentPlan": "FLEXIBLE",
        "paymentCycle": {
          "duration": 1,
          "periodType": "MONTH"
        }
      },
    }
  ],
}

Pada tahap ini, Anda seharusnya memiliki Hak, Penawaran, dan Akun Penagihan. Mulai ubah paket pembayaran menggunakan metode changeOffer.

ChangeOfferRequest
{
  "name": "accounts/abc/customers/123/entitlements/entitlement_id1",
  "offer": "accounts/abc/offers/offer_id1",
  "billing_account": "accounts/abc/billingAccounts/billing_account_id2",
  "parameters": [{
    "name": "max_units",
    "value": {
      "int64Value": "100"
    }
  }]
}
ChangeOfferResponse
{
  "name": "operations/operation_id1"
}

Mengupgrade atau mendowngrade hak Google Workspace

Untuk mengupgrade atau mendowngrade hak Google Workspace, ikuti langkah-langkah berikut:

Dengan Hak, panggil metode listPurchasableSkus untuk mengambil daftar PurchasableSkus yang dapat digunakan untuk upgrade atau downgrade.

ListPurchasableSkusRequest
{
  "customer": "accounts/123/customers/abc",
  "changeOfferPurchase": {
    "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
    "changeType": "UPGRADE"
  }
}
ListPurchasableSkusResponse
{
  "purchasableSkus": [
    {
      "sku": {
        "name": "products/product_id/skus/sku_id1",
        "product": {
          "name": "products/product_id",
        }
      }
    },
    {
      "sku": {
        "name": "products/product_id/skus/sku_id2",
        "product": {
          "name": "products/product_id",
        },
      }
    }
  ]
}

Dengan PurchasableSku, gunakan metode queryEligibleBillingAccounts untuk menemukan kumpulan BillingAccounts yang dapat digunakan untuk membayar Hak.

Jika Anda ingin membayar dengan mata uang tertentu, pilih BillingAccount dengan mata uang tersebut.

 QueryEligibleBillingAccountsRequest
 {
   "customer": "accounts/123/customers/abc",
   "skus": ["products/product_id/skus/sku_id1"]
 }
 QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

Dengan Entitlement dan BillingAccount, gunakan metode listPurchasableOffers untuk menemukan PurchasableOffer.

  ListPurchasableOffersRequest
  {
    "customer": "accounts/123/customers/abc",
    "changeOfferPurchase": {
      "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1",
      "billingAccount": "accounts/123/billingAccounts/billing_account_id2"
    }
  }
  ListPurchasableOffersResponse
  {
    "purchasableOffers": [
      {
        "offer": {
          "name": "accounts/123/offers/offer_id1",
        },
        "sku": {
          "name": "products/product_id/skus/sku_id1",
        },
        "plan": {
          "paymentPlan": "FLEXIBLE",
          "paymentCycle": {
            "duration": 1,
            "periodType": "MONTH"
          }
        },
      }
    ],
  }
  ```

Pada tahap ini, Anda akan memiliki Entitlement, PurchasableOffer, dan BillingAccount. Mulai upgrade atau downgrade menggunakan metode changeOffer.

Buat objek Entitlement dan isi nama, offer, billingAccount dan parameter yang diperlukan.

   ChangeOfferRequest
   {
     "name": "accounts/abc/customers/123/entitlements/entitlement_id1",
     "offer": "accounts/abc/offers/offer_id1",
     "billing_account": "accounts/abc/billingAccounts/billing_account_id2",
     "parameters": [{
       "name": "max_units",
       "value": {
         "int64Value": "100"
       }
     }]
   }
   ChangeOfferResponse
   {
     "name": "operations/operation_id1"
   }
   ```

Mentransfer hak

Bagian ini membantu Anda mentransfer hak untuk pelanggan Google Workspace dan Chrome yang sudah ada dari partner mereka sebelumnya.

Untuk mendapatkan bantuan mentransfer pelanggan di Partner Sales Console, lihat panduan kami tentang cara mentransfer pelanggan ke akun partner atau Akun Google

Pelanggan Google Workspace hanya dapat membeli hak dari satu partner atau satu partner dan Google.

Selama transfer, hak yang ada akan otomatis dibatalkan sebelum dibuat lagi di bagian partner baru. Jika pelanggan memiliki hak paket komitmen, pelanggan tersebut akan memulai masa komitmen baru setelah transfer.

Sebelum memulai

Untuk mengelola hak bagi pelanggan, Anda memerlukan token transfer yang dibuat pelanggan. Hubungi pelanggan dan berikan ID Publik Partner Anda agar mereka dapat membuat token transfer. Setelah mereka membuat token, pelanggan harus mengirimkan token transfer mereka kembali kepada Anda untuk menyelesaikan prosesnya. Masa berlaku token ini akan berakhir 14 hari setelah dibuat. Anda juga memerlukan domain atau ID Cloud Identity pelanggan.

Saat membuat token transfer, pelanggan memilih hak yang ingin ditransfer ke reseller barunya. Anda perlu mentransfer semua hak yang dipilih selama proses ini.

Untuk mentransfer hak, ikuti langkah-langkah berikut:

Jika hanya memiliki domain pelanggan, Anda dapat menggunakan Cloud Channel API untuk menampilkan ID Cloud Identity mereka. Panggil checkCloudIdentityAccountsExist dengan domain pelanggan dan, jika domain tersebut ada, API akan menampilkan ID Cloud Identity pelanggan.

Mulai transfer menggunakan metode customers.import untuk mengimpor data pelanggan.
```
ImportCustomerRequest
{
  "parent": "accounts/abc",
  "domain": "domain"
}
```

Dengan ID Cloud Identity pelanggan, panggil listTransferableSkus untuk mengambil daftar transferableSku pelanggan Periksa transferEligibility setiap objek guna memastikan Anda dapat membeli SKU yang terkait.

ListTransferableSkusRequest
{
  "parent": "accounts/abc",
  "cloudIdentityId": "cloud_identity_id"
}
ListTransferableSkusResponse
{
  "transferableSku": [
    {
      "sku": {
           "name": "products/product_id/skus/voice_sku_id1",
      },
    },
    {
      "sku": {
           "name": "products/product_id/skus/google_workspace_sku_id2",
      },
    },
    {
      "sku": {
           "name": "products/product_id/skus/google_workspace_chrome_sku_id3",
      },
    }
  ],
}

Setelah memiliki daftar TransferableSkus, Anda perlu menentukan BillingAccount yang akan digunakan untuk membayar hak. Gunakan metode queryEligibleBillingAccounts untuk menemukan kumpulan BillingAccount yang dapat digunakan untuk setiap TransferableSku.

Perlu diketahui bahwa TransferableSkus tertentu harus memiliki akun penagihan Google Workspace yang sama. Itulah sebabnya queryEligibleBillingAccounts menampilkan grup SKU yang memberi tahu Anda TransferableSkus mana yang perlu menggunakan BillingAccount yang sama. Jika ada beberapa akun penagihan Google Workspace untuk grup SKU tertentu, Anda dapat memilih salah satu akun penagihan Google Workspace dan menggunakannya untuk setiap TransferableSku dalam grup.

QueryEligibleBillingAccountsRequest
{
  "customer": "accounts/123/customers/abc",
  "skus": ["products/product_id/skus/voice_sku_id1","products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3"]
}
QueryEligibleBillingAccountsResponse
 {
   "skuPurchaseGroups": [
     {
       "skus": [
         "products/product_id/skus/voice_sku_id1"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/voice_billing_account_id1",
             "displayName": "Google_Workspace_Voice_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         }
       ]
     },
     {
       "skus": [
         "products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3"
       ],
       "billingAccountPurchaseInfos": [
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/gw_billing_account_id1",
             "displayName": "Google_Workspace_USD_US_1",
             "currencyCode": "USD",
             "regionCode": "US"
           }
         },
         {
           "billingAccount": {
             "name": "accounts/123/billingAccounts/gw_billing_account_id2",
             "displayName": "Google_Workspace_CAD_CA_1",
             "currencyCode": "CAD",
             "regionCode": "CA"
           }
         }
       ]
     }
   ]
 }
 ```

Untuk setiap pasangan TransferableSku dan BillingAccount, gunakan metode listTransferableOffers untuk menemukan TransferableOffers yang tersedia . Pada tahap ini, Anda akan memiliki daftar tuple pelanggan yang terdiri dari TransferableSku, BillingAccounts, dan TransferableOffer.

ListTransferableOffersRequest
{
  "parent": "accounts/abc",
  "cloudIdentityId": "cloud_identity_id",
  "sku": "products/product_id/skus/voice_sku_id1",
  "billingAccount": "ccounts/123/billingAccounts/voice_billing_account_id1"
}
ListTransferableOffersResponse
   {
     "transferableOffers": [
       {
         "offer": {
           "name": "accounts/123/offers/voice_offer_id1",
         },
         "sku": {
           "name": "products/product_id/skus/voice_sku_id1",
         },
         "plan": {
           "paymentPlan": "FLEXIBLE",
           "paymentCycle": {
             "duration": 1,
             "periodType": "MONTH"
           }
         },
       }
     ],
   }

Untuk setiap tuple, membuat objek Entitlement baru yang sesuai, setiap Entitlement memerlukan Offer, BillingAccount, dan parameter apa pun yang diperlukan. Panggil metode transferEntitlements untuk melakukan transfer.

TransferEntitlementsRequest
{
  "parent": "accounts/abc/customers/123",
  "entitlements": [
    {
      "offer": "accounts/123/offers/voice_offer_id1",
      "maxUnits": 100,
      "billingAccount": "accounts/123/billingAccounts/voice_billing_account_id1"
    },
    {
      "offer": "accounts/123/offers/gw_offer_id2",
      "maxUnits": 150,
      "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1"
    }
    {
      "offer": "accounts/123/offers/gw_chrome_offer_id3",
      "maxUnits": 200,
      "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1"
    }
  ]
}
TransferEntitlementsResponse
{
  "name": "operations/operation_id1"
}