Halaman ini diterjemahkan oleh Cloud Translation API.

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 Pemula untuk Beberapa Akun Penagihan Google Workspace .

Membuat 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 BillingAccount Google Workspace yang dapat digunakan untuk membayar hak.

Jika Anda ingin membayar dalam 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 pada 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 Hak Memiliki menjadi paket pembayaran berbayar, ada beberapa langkah tambahan untuk memilih akun penagihan Google Workspace.

Untuk mengubah paket pembayaran pada 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 tentang 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 Customer dan Sku, gunakan metode queryEligibleBillingAccounts untuk menemukan kumpulan BillingAccount yang dapat digunakan untuk membayar Hak ini. Jika Anda ingin membayar dalam 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. 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 berupa 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 harus memiliki Entitlement, Offer, dan BillingAccount. 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 dalam 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 harus memiliki Hak, Penawaran yang Dapat Dibeli, dan BillingAccount. Mulai upgrade atau downgrade menggunakan metode changeOffer.

Buat objek Hak dan isi nama, penawaran, billingAccount, dan parameter apa pun 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 dalam mentransfer pelanggan di Partner Sales Console, lihat panduan kami tentang 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 bawah partner baru. Jika pelanggan memiliki hak paket komitmen, hak tersebut akan memulai masa berlaku komitmen baru setelah transfer.

Sebelum memulai

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

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

Untuk mentransfer hak, ikuti langkah-langkah berikut:

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

Mulai transfer dengan 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 untuk memastikan Anda dapat membeli SKU 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.

Perhatikan bahwa TransferableSkus tertentu harus menggunakan 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 harus 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, buat objek Hak yang sesuai yang baru, setiap Hak memerlukan Penawaran, BillingAccount, dan parameter 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"
}