本頁面由 Cloud Translation API 翻譯而成。

管理 Google Workspace 和 Google Chrome 授權

本頁面說明如何管理 Google Workspace 和 Google Chrome 產品的客戶授權。

先決條件

繼續操作前，請先確認您的經銷商帳戶是否只有一個 Google Workspace 帳單帳戶，還是有多個 Google Workspace 帳單帳戶。如要進一步瞭解這個主題，請參閱「多個 Google Workspace 帳單帳戶入門指南」。

建立授權

事前準備

您必須先完成 Customer 設定，才能繼續操作。

如要建立授權，請按照下列步驟操作：

使用客戶名稱呼叫 listPurchasableSkus，即可擷取 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",
        },
      }
    }
  ]
}

針對所選的 PurchasableSku，請使用 queryEligibleBillingAccounts 方法，找出可用於支付授權費用的 Google Workspace BillingAccount。

如果您想以特定貨幣付款，請選取使用該貨幣的 BillingAccount。

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"
          }
        }
      ]
    }
  ]
}

使用所選的 PurchasableSku 和 BillingAccount，使用 listPurchasableOffers 方法找出可用的 PurchasableOffer

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"
        }
      },
      "priceReferenceId": "price_reference_id_123"
    }
  ],
}

此時，您應該會擁有 BillingAccount，用於支付 Entitlement 和 PurchasableOffer 的費用。開始使用 create 方法建立授權。
1. 建立授權，並填入優惠、billingAccount 和任何其他必要參數。當 PurchasableOffer 中含有價格參考 ID 時，請在授權中填入該 ID，確保新授權含有上述報價價格。如果沒有這個價格參照 ID，我們無法保證從 ListPurchasableOffersResponse 傳回的折扣和有效價格，會與此 CreateEntitlement 呼叫相同。填入這個價格參照 ID 可確保這項新授權的價格相符。
```
CreateEntitlementRequest
{
  "parent": "accounts/123/customers/abc",
  "entitlement": {
    "offer": "accounts/123/offers/offer_id1",
    "maxUnits": 100,
    "billingAccount": "accounts/123/billingAccounts/billing_account_id2",
    "priceReferenceId": "price_reference_id_123"
  }
}
CreateEntitlementResponse
{
  "name": "operations/operation_id1"
}
```

變更 Google Workspace 授權的付款方案

事前準備

使用免付費或試用付款 plan 的 Google Workspace 授權，不需使用 Google Workspace 帳單資料。如要將授權的付款方案變更為付費方案，您必須額外完成幾個步驟，才能選取 Google Workspace 帳單帳戶。

如要變更 Google Workspace 授權的付款方案，請按照下列步驟操作：

只有當現有授權有免費或試用付款方案時，才需要執行前兩個步驟。

針對優惠，請使用 lookupOffer 方法，找出優惠的 Sku 資訊。

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",
   }
}

使用 Customer 和 Sku，使用 queryEligibleBillingAccounts 方法找出可用於支付此授權的 BillingAccount 組合。如果您想以特定貨幣付款，請選取使用該貨幣的 BillingAccount。

 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"
           }
         }
       ]
     }
   ]
 }
 ```

使用授權和 BillingAccount，使用 listPurchasableOffers 方法找出任何 PurchasableOffer。如果現有授權方案已包含付費方案，就不需要 BillingAccount，在這種情況下，系統會使用現有的 BillingAccount。如要變更付款方案，purchase_option 欄位必須為 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"
        }
      },
      "priceReferenceId": "price_reference_id_123"
    }
  ],
}

此時，您應該會擁有授權、商品和 BillingAccount。請使用 changeOffer 方法開始變更付款方案。在 PurchasableOffer 中填入授權的價格參考 ID，確保新授權包含上述報價的價格。如果沒有這個價格參考 ID，就無法保證從 ListPurchasableOffersResponse 傳回的折扣和有效價格，會與這個 ChangeOffer 呼叫相同。填入這個價格參照 ID，可確保這項新授權的價格相符。
```
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"
    }
  }],
  "priceReferenceId": "price_reference_id_123"
}
ChangeOfferResponse
{
  "name": "operations/operation_id1"
}
```

升級或降級 Google Workspace 授權

如要升級或降級 Google Workspace 授權，請按照下列步驟操作：

使用授權，呼叫 listPurchasableSkus 方法，擷取可用於升級或降級的 PurchasableSkus 清單。

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",
        },
      }
    }
  ]
}

使用 PurchasableSku，使用 queryEligibleBillingAccounts 方法找出可用於支付授權的 BillingAccounts 組合。

如果您想以特定貨幣付款，請選取使用該貨幣的 BillingAccount。

 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"
           }
         }
       ]
     }
   ]
 }
 ```

使用授權和 BillingAccount，使用 listPurchasableOffers 方法找出任何 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"
          }
        },
        "priceReferenceId": "price_reference_id_123"
      }
    ],
  }
  ```

此時，您應該已具備授權、可購買的商品和帳單帳戶。使用 changeOffer 方法開始升級或降級。
1. 建立授權物件，並填入名稱、優惠、帳單帳戶和任何必要參數。當 PurchasableOffer 中含有價格參考 ID 時，請在授權中填入該 ID，確保新授權含有上述報價價格。如果沒有這個價格參照 ID，我們無法保證從 ListPurchasableOffersResponse 傳回的折扣和有效價格，會與此 ChangeOffer 呼叫相同。填入這個價格參照 ID 可確保這項新授權的價格相符。
```
   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"
       }
     }],
     "priceReferenceId": "price_reference_id_123"
   }
   ChangeOfferResponse
   {
     "name": "operations/operation_id1"
   }
   ```
```

轉移授權

本節說明如何將現有 Google Workspace 和 Chrome 客戶的授權，從先前的合作夥伴轉移至您。

如需在 Partner Sales Console 中轉移客戶的相關說明，請參閱轉移客戶至合作夥伴帳戶或 Google 帳戶的指南

Google Workspace 客戶只能向單一合作夥伴或單一合作夥伴和 Google 購買授權。

在轉移期間，系統會自動取消現有的授權，然後在新的合作夥伴下重新建立。如果客戶擁有約期方案授權，則會在轉移後開始新的約期。

事前準備

如要管理客戶的授權，您需要客戶產生的轉移權杖。請與客戶聯絡，並提供您的合作夥伴公開 ID，方便對方產生轉移權杖。建立權杖後，客戶必須將轉移權杖傳回給您，才能完成程序。這些權杖的有效期限為建立後 14 天。你也需要客戶的網域或 Cloud Identity ID。

客戶建立轉移權杖時，會選取要轉移至新經銷商的授權。您必須在過程中轉移所有所選授權。

如要轉移授權，請按照下列步驟操作：

如果您只有客戶的網域，可以使用 Cloud Channel API 傳回客戶的 Cloud Identity ID。使用客戶的網域呼叫 checkCloudIdentityAccountsExist，如果網域存在，API 就會傳回客戶的 Cloud Identity ID。

使用 customers.import 方法匯入客戶資料，即可開始轉移作業。

ImportCustomerRequest
{
  "parent": "accounts/abc",
  "domain": "domain"
}

使用客戶的 Cloud Identity ID 時，請呼叫 listTransferableSkus 來擷取客戶的 transferableSku 清單。檢查每個物件的 transferEligibility，確認您可以購買相關的 SKU。

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",
      },
    }
  ],
}

有了 TransferableSkus 清單後，您需要決定要使用哪個 BillingAccount 支付授權費用。使用 queryEligibleBillingAccounts 方法找出可用於每個 TransferableSku 的一組 BillingAccount。

請注意，某些 TransferableSkus 必須共用相同的 Google Workspace 帳單帳戶，因此 queryEligibleBillingAccounts 會傳回 sku 群組，告知您哪些 TransferableSkus 需要使用相同的 BillingAccount。如果特定 SKU 群組有多個 Google Workspace 帳單帳戶，您可以選擇其中一個 Google Workspace 帳單帳戶，並將其用於群組中的每個 TransferableSku。

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"
           }
         }
       ]
     }
   ]
 }
 ```

針對每個 TransferableSku 和 BillingAccount 組合，請使用 listTransferableOffers 方法找出可用的 TransferableOffers。此時，您應該會取得客戶的元組清單，其中包含 TransferableSku、BillingAccounts 和 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"
           }
         },
         "priceReferenceId": "price_reference_id_voice_offer_12"
       }
     ],
   }

針對每個元組建立新的對應授權物件，每個授權都需要 Offer、BillingAccount 和任何必要參數。當授權項目出現在可購買的商品中時，請在授權項目中填入價格參考 ID，以確保新授權項目含有上述報價價格。如果沒有這個價格參考 ID，就無法保證 ListPurchasableOffersResponse 傳回的折扣和有效價格，會與這個 TransferEntitlements 呼叫相同。填入這個價格參照 ID 可確保這項新授權的價格相符。如要執行轉移作業，請呼叫 transferEntitlements 方法。

TransferEntitlementsRequest
{
  "parent": "accounts/abc/customers/123",
  "entitlements": [
    { 
      "offer": "accounts/123/offers/voice_offer_id1",
      "maxUnits": 100,
      "billingAccount": "accounts/123/billingAccounts/voice_billing_account_id1",
      "priceReferenceId": "price_reference_id_voice_offer_12"
    },
    {
      "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",
      "priceReferenceId": "price_reference_id_chrome_offer_34"
    }   
  ]
}
TransferEntitlementsResponse
{
  "name": "operations/operation_id1"
}

管理 Google Workspace 和 Google Chrome 授權 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

先決條件

建立授權

事前準備

變更 Google Workspace 授權的付款方案

事前準備

升級或降級 Google Workspace 授權

轉移授權

事前準備

管理 Google Workspace 和 Google Chrome 授權