Diese Seite wurde von der Cloud Translation API übersetzt.

Berechtigungen für Google Workspace und Google Chrome verwalten

Auf dieser Seite wird beschrieben, wie Sie Berechtigungen für Kunden für Google Workspace- und Google Chrome-Produkte verwalten.

Voraussetzung

Bevor Sie fortfahren, müssen Sie feststellen, ob Ihr Resellerkonto ein einzelnes Google Workspace-Rechnungskonto oder mehrere Google Workspace-Rechnungskonten hat. Weitere Informationen zu diesem Thema finden Sie im Einstiegsleitfaden für mehrere Google Workspace-Abrechnungskonten.

Berechtigung erstellen

Hinweise

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

So erstellst du eine Berechtigung:

Rufe mit dem Namen des Kunden 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 für die ausgewählte PurchasableSku die Methode queryEligibleBillingAccounts, um eine Reihe von Google Workspace-BillingAccount 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"
          }
        }
      ]
    }
  ]
}

Verwenden Sie die Methode listPurchasableOffers, um mit der ausgewählten PurchasableSku und dem ausgewählten BillingAccount die verfügbaren PurchasableOffer zu ermitteln.

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 Abrechnungskonto haben, über das die Entitlement und das PurchasableOffer bezahlt werden. Erstellen Sie die Berechtigung mit der Methode create.

Erstelle eine Berechtigung und fülle die Felder „Angebot“, „billingAccount“ und alle anderen erforderlichen Parameter aus.

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

Google Workspace-Berechtigungen mit einer kostenlosen oder Testzahlung plan haben kein Google Workspace-Rechnungskonto. Wenn Sie das Preismodell für eine Berechtigung in ein kostenpflichtiges Preismodell ändern möchten, müssen Sie einige zusätzliche Schritte ausführen, um ein Google Workspace-Rechnungskonto auszuwählen.

So ändern Sie das Preismodell für Google Workspace-Berechtigungen:

Die ersten beiden Schritte sind nur erforderlich, wenn für die vorhandene Berechtigung ein kostenloser oder Testzeitraum gilt.

Verwenden Sie für das Angebot die Methode lookupOffer, um Sku-Informationen zum Angebot zu erhalten.

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 die Methode „queryEligibleBillingAccounts“, um mit dem Kunden und der Artikelnummer eine Reihe von Rechnungskonten zu finden, mit denen diese Berechtigung bezahlt werden kann. Wenn Sie in einer bestimmten Währung bezahlen möchten, wählen Sie ein Abrechnungskonto 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, um mit „Entitlement“ und „BillingAccount“ alle „PurchasableOffer“ zu finden. Das Rechnungskonto ist nicht erforderlich, wenn für die vorhandene Berechtigung bereits ein kostenpflichtiger Tarif vorhanden ist. In diesem Fall wird das vorhandene Rechnungskonto verwendet. Wenn Sie das Preismodell ändern möchten, muss das Feld „purchase_option“ changeOfferPurchase sein.

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

Sie sollten jetzt die Berechtigung, das Angebot und das Rechnungskonto haben. Ändern Sie den Tarif mit 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 führen Sie ein Upgrade oder Downgrade von Google Workspace-Berechtigungen durch:

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

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 für die PurchasableSku die Methode queryEligibleBillingAccounts, um eine Reihe von BillingAccounts 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 „Entitlement“ und „BillingAccount“, um alle „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"
          }
        },
      }
    ],
  }
  ```

Sie sollten jetzt die Berechtigung, das kaufbare Angebot und das Abrechnungskonto haben. Führen Sie ein Upgrade oder Downgrade mit der Methode changeOffer aus.

Erstelle ein Berechtigungsobjekt und gib den Namen, das Angebot, das Abrechnungskonto und alle erforderlichen Parameter an.

   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 Anleitungen zum Übertragen von Kunden in ein Partnerkonto oder ein Google-Konto.

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

Während der Übertragung werden vorhandene Berechtigungen automatisch gekündigt, bevor sie für den neuen Partner neu erstellt werden. Wenn ein Kunde Berechtigungen für einen Zusicherungsplan hat, beginnt nach der Übertragung ein neuer Zusicherungszeitraum.

Hinweise

Wenn Sie Berechtigungen für einen Kunden verwalten möchten, benötigen Sie 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 der Kunde ein Token erstellt hat, muss er es an dich zurücksenden, damit der Vorgang abgeschlossen werden kann. Diese Token laufen 14 Tage nach der Erstellung ab. Außerdem benötigen Sie die Domain oder Cloud Identity-ID des Kunden.

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

So übertragen Sie Berechtigungen:

Wenn du nur die Domain des Kunden hast, kannst du die Cloud Identity-ID mit der Cloud Channel API zurückgeben. Rufe checkCloudIdentityAccountsExist mit der Domain des Kunden auf. Wenn die Domain vorhanden ist, gibt die API die Cloud Identity-ID des Kunden zurück.

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

Rufe mit der Cloud Identity-ID des Kunden listTransferableSkus auf, um eine Liste der transferableSku des Kunden abzurufen. Prüfe die transferEligibility jedes Objekts, um sicherzustellen, dass du die zugehörige Artikelnummer kaufen kannst.

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

Nachdem Sie eine Liste der übertragbaren Artikelnummern haben, müssen Sie das Abrechnungskonto ermitteln, mit dem die Berechtigungen bezahlt werden sollen. Verwenden Sie die Methode queryEligibleBillingAccounts, um eine Reihe von Rechnungskonten zu finden, die für jede übertragbare Artikelnummer verwendet werden können.

Bestimmte „ÜbertragbareSkus“ müssen dasselbe Google Workspace-Rechnungskonto verwenden. Daher gibt queryEligibleBillingAccounts eine Sku-Gruppe zurück, aus der hervorgeht, welche „ÜbertragbareSkus“ dasselbe „BillingAccount“ verwenden müssen. Wenn es für eine bestimmte SKU-Gruppe mehrere Google Workspace-Rechnungskonten gibt, können Sie eines davon auswählen und für alle „ÜbertragbareSku“ 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 Paar aus „ÜbertragbareSku“ und „Abrechnungskonto“ die Methode listTransferableOffers, um verfügbare TransferableOffers zu ermitteln. Sie sollten jetzt die Liste der Tupel des Kunden mit den Elementen „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"
           }
         },
       }
     ],
   }

Erstelle für jedes Tupel ein neues entsprechendes Berechtigungsobjekt. Jede Berechtigung benötigt ein Angebot, ein Abrechnungskonto und alle erforderlichen Parameter. Rufen Sie die Methode transferEntitlements auf, um die Übertragung auszufü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"
}