Berechtigungen für Google Workspace und Google Chrome verwalten

Auf dieser Seite wird beschrieben, wie Kundenberechtigungen für Google Workspace- und Google Chrome-Produkte verwaltet werden.

Voraussetzung

Bevor Sie fortfahren, prüfen Sie, ob Ihr Reseller-Konto ein einzelnes Google Workspace-Rechnungskonto oder mehrere Google Workspace-Rechnungskonten hat. Weitere Informationen zu diesem Thema finden Sie im Startleitfaden für mehrere Google Workspace-Rechnungskonten.

Berechtigung erstellen

Hinweise

Sie müssen Customer einrichten, bevor Sie fortfahren können.

So erstellst du eine Berechtigung:

Rufen Sie mit dem Kundennamen listPurchasableSkus auf, um eine Liste von PurchasableSkus abzurufen.

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

Verwenden Sie bei dem ausgewählten PurchasableSku die Methode queryEligibleBillingAccounts, um eine Reihe von Google Workspace-BillingAccount zu finden, mit der die Berechtigung bezahlt werden kann.

Wenn Sie in einer bestimmten Währung bezahlen möchten, wählen Sie ein Rechnungskonto mit dieser Währung aus.

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

Verwenden Sie bei dem ausgewählten PurchasableSku und BillingAccount die Methode listPurchasableOffers, um die verfügbare PurchasableOffer zu finden.

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

Sie sollten jetzt das Rechnungskonto haben, über das Entitlement und das PurchasableOffer bezahlt werden. Beginne mit dem Erstellen der Berechtigung mit der Methode create.

Erstellen Sie eine Berechtigung und legen Sie das Angebot, das Rechnungskonto und alle anderen erforderlichen Parameter fest.

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

Preismodell für Google Workspace-Berechtigungen ändern

Hinweise

Für Google Workspace-Berechtigungen mit einer kostenlosen Zahlung oder einem Testzeitraum plan ist kein Google Workspace-Rechnungskonto vorhanden. Zum Ändern des Preismodells für eine Berechtigung in ein kostenpflichtiges Preismodell müssen Sie ein paar zusätzliche Schritte ausführen, um ein Google Workspace-Rechnungskonto auszuwählen.

So änderst du das Preismodell für Google Workspace-Berechtigungen:

Die ersten beiden Schritte sind nur erforderlich, wenn die vorhandene Berechtigung ein kostenloses Preismodell oder ein Probeabo hat.

Verwende in Verbindung mit dem Angebot die Methode lookupOffer, um Sku-Informationen zum Angebot zu finden.

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

Verwende bei dem Kunden und der Artikelnummer die Methode „queryEligibleBillingAccounts“, um eine Reihe von BillingAccount zu finden, mit dem diese Berechtigung bezahlt werden kann. Wenn Sie in einer bestimmten Währung bezahlen möchten, wählen Sie ein Rechnungskonto mit dieser Währung aus.

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

Verwende die Methode listPurchasableOffers mit Entitlements und BillingAccount, um ein beliebiges PurchasableOffer zu finden. Das BillingAccount wird nicht benötigt, wenn die vorhandene Berechtigung bereits einen kostenpflichtigen Tarif hat. In diesem Fall wird das vorhandene BillingAccount verwendet. Zum Ändern des Preismodells muss das Feld „purchase_option“ den Wert changeOfferPurchase haben.

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

Jetzt sollten Sie die Berechtigung, das Angebot und das Rechnungskonto haben. Ändern Sie das Abrechnungsmodell mithilfe der Methode 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"
}

Google Workspace-Berechtigungen upgraden oder downgraden

So kannst du Google Workspace-Berechtigungen upgraden oder downgraden:

Rufe mit der Berechtigung die Methode listPurchasableSkus auf, um eine Liste von PurchasableSkus abzurufen, die für ein Upgrade oder Downgrade verwendet werden kann.

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

Verwende bei PurchasableSku die Methode queryEligibleBillingAccounts, um eine Reihe von Rechnungskonten zu finden, mit denen die Berechtigung bezahlt werden kann.

Wenn Sie in einer bestimmten Währung bezahlen möchten, wählen Sie ein Rechnungskonto mit dieser Währung aus.

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

Verwende die Methode listPurchasableOffers mit Entitlements und BillingAccount, um ein beliebiges PurchasableOffer zu finden.

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

Jetzt sollten Sie die Berechtigung, das PurchasableOffer und das BillingAccount haben. Führen Sie mit der Methode changeOffer ein Upgrade oder Downgrade durch.

Erstellen Sie ein Berechtigungsobjekt und geben Sie den Namen, das Angebot, das Rechnungskonto und alle erforderlichen Parameter ein.

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

Berechtigungen übertragen

In diesem Abschnitt erfahren Sie, wie Sie Berechtigungen für bestehende Google Workspace- und Chrome-Kunden von ihrem bisherigen Partner übertragen.

Informationen zum Übertragen von Kunden in der Partner Sales Console finden Sie in unseren Leitfäden zum Übertragen von Kunden zu einem Partnerkonto oder einem Google-Konto.

Google Workspace-Kunden können Berechtigungen nur von einem einzelnen Partner oder einem einzigen Partner und von Google erwerben.

Während der Übertragung werden vorhandene Berechtigungen automatisch storniert, bevor sie unter dem neuen Partner wieder erstellt werden. Wenn ein Kunde Berechtigungen für Zusicherungen hat, beginnt nach der Übertragung eine neue Laufzeit der Zusicherung.

Hinweise

Zum Verwalten von Berechtigungen für einen Kunden benötigst du ein vom Kunden generiertes Übertragungstoken. Wenden Sie sich an den Kunden und geben Sie Ihre öffentliche Partner-ID an, damit er ein Übertragungstoken generieren kann. Nachdem er ein Token erstellt hat, muss der Kunde sein Übertragungstoken an Sie zurücksenden, um den Vorgang abzuschließen. Diese Tokens laufen 14 Tage nach der Erstellung ab. Sie benötigen außerdem die Domain des Kunden oder die Cloud Identity-ID.

Wenn der Kunde sein Übertragungstoken erstellt, wählt er die Berechtigungen aus, die er an seinen neuen Reseller übertragen möchte. Du musst während des Vorgangs alle ausgewählten Berechtigungen übertragen.

So übertragen Sie Berechtigungen:

Wenn Sie nur die Domain des Kunden haben, können Sie die Cloud Identity-ID über die Cloud Channel API zurückgeben. Rufen Sie checkCloudIdentityAccountsExist mit der Domain des Kunden auf. Wenn die Domain vorhanden ist, gibt die API die Cloud Identity-ID des Kunden zurück.

Starten Sie die Übertragung mit der Methode customers.import, um die Daten des Kunden zu importieren.
```
ImportCustomerRequest
{
  "parent": "accounts/abc",
  "domain": "domain"
}
```

Rufen Sie mit der Cloud Identity-ID des Kunden listTransferableSkus auf, um eine Liste der transferableSku des Kunden abzurufen. Prüfen Sie die transferEligibility jedes Objekts, um sicherzugehen, dass Sie die zugehörige Artikelnummer erwerben können.

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

Da Sie nun eine Liste von TransferableSkus haben, müssen Sie festlegen, welches Rechnungskonto zum Bezahlen der Berechtigungen verwendet werden soll. Verwenden Sie die Methode queryEligibleBillingAccounts, um eine Gruppe von BillingAccount zu finden, die für jeden TransferableSku verwendet werden kann.

Bestimmte TransferableSkus müssen dasselbe Google Workspace-Rechnungskonto verwenden. Deshalb gibt queryEligibleBillingAccounts eine Artikelnummergruppe zurück, die Sie darüber informiert, welche TransferableSkus dasselbe Rechnungskonto verwenden müssen. Wenn für eine bestimmte SKU-Gruppe mehrere Google Workspace-Rechnungskonten vorhanden sind, können Sie eines der Google Workspace-Rechnungskonten auswählen und für jede TransferableSku in der Gruppe verwenden.

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

Verwenden Sie für jedes TransferableSku- und BillingAccount-Paar die Methode listTransferableOffers, um nach verfügbarem TransferableOffers zu suchen. Sie sollten nun die Tupel des Kunden mit TransferableSku, BillingAccounts und TransferableOffer haben.

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

Für jedes Tupel muss ein neues entsprechendes Berechtigungsobjekt erstellt werden. Außerdem benötigt jede Berechtigung ein Angebot, ein Rechnungskonto und alle erforderlichen Parameter. Rufen Sie die Methode transferEntitlements auf, um die Übertragung durchzuführen.

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