Diese Seite wurde von der Cloud Translation API übersetzt.

Google Workspace- und Google Chrome-Berechtigungen verwalten

Auf dieser Seite wird beschrieben, wie Sie Kundenberechtigungen für Google Workspace verwalten und Google Chrome-Produkten.

Voraussetzung

Bevor Sie fortfahren, ermitteln Sie, ob Ihr Reseller-Konto über ein einzelnes Google Workspace-Rechnungskonto oder Abrechnung für mehrere Google Workspace-Konten Konten. Weitere Informationen zu diesem Thema Lesen Sie den Startleitfaden für mehrere Google Workspace-Rechnungskonten. .

Berechtigung erstellen

Hinweise

Du brauchst Customer einrichten, bevor Sie fortfahren können.

So erstellst du eine Berechtigung:

Mit dem Kundennamen listPurchasableSkus anrufen um eine Liste abzurufen, von 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",
        },
      }
    }
  ]
}

Verwenden Sie für die ausgewählte PurchasableSku die Methode queryEligibleBillingAccounts, um eine Reihe von Google Workspace-BillingAccount-Gutscheincodes 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 in dieser Währung.

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 mit dem ausgewählten PurchasableSku und BillingAccount das Feld listPurchasableOffers zur Ermittlung der Verfügbar 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"
        }
      },
    }
  ],
}

Sie sollten jetzt das Abrechnungskonto haben, über das die Entitlement und das PurchasableOffer bezahlt werden. Erstellen Sie die Berechtigung zuerst mithilfe von create .

Erstelle eine Berechtigung und befülle das Angebot, das Rechnungskonto und alle weitere erforderliche Parameter.

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 Testversion Zahlung plan hat kein Google Workspace-Rechnungskonto. Wenn Sie das Abrechnungsmodell für eine Wenn du ein kostenpflichtiges Preismodell nutzen möchtest, sind einige zusätzliche Schritte erforderlich, Wählen Sie ein Google Workspace-Rechnungskonto aus.

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

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

Verwenden Sie für das Angebot lookupOffer Sku Informationen zu für das Angebot.

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

Verwenden Sie für „Customer“ und „SKU“ die Methode „queryEligibleBillingAccounts“, Rechnungskonto finden, das zum Bezahlen verwendet werden kann Berechtigung. Wenn Sie in einer bestimmten Währung bezahlen möchten, wählen Sie eine Rechnungskonto mit in dieser Währung.

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

Jetzt sollten Sie die Berechtigung, das Angebot und das Rechnungskonto haben. Beginnen Sie mit der Änderung des Preismodells, indem Sie 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: Schritte:

Rufe mit der Berechtigung die Methode listPurchasableSkus auf, um eine Liste der PurchasableSkus, die für Upgrades oder Downgrades 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",
        },
      }
    }
  ]
}

Verwenden Sie für PurchasableSku die Methode queryEligibleBillingAccounts, eine Reihe von Rechnungskonten suchen, die zum Bezahlen der Berechtigung verwendet werden können.

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

 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 bei der Berechtigung und dem Rechnungskonto die Methode listPurchasableOffers, um nach einem PurchasableOffer zu suchen.

  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. Upgrade oder Downgrade mithilfe der changeOffer ausführen .

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

   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 wird die Übertragung von Berechtigungen für vorhandene Google Workspace- und Chrome-Kunden ihrer bisherigen Partner.

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

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

Während der Übertragung werden vorhandene Berechtigungen automatisch abgebrochen, bevor werden sie unter dem neuen Partner noch einmal erstellt. Wenn ein Kunde einen Vertrag mit Bindung hat Berechtigungen beginnen diese nach der Übertragung mit einer neuen Laufzeit.

Hinweise

Zum Verwalten von Berechtigungen für einen Kunden benötigen Sie ein vom Kunden generiertes Übertragungstoken Wenden Sie sich an den Kunden und geben Sie Öffentliche ID des Partners damit sie ein Übertragungstoken generieren können. Nachdem ein Token erstellt wurde, muss das Übertragungstoken an Sie zurücksenden, um den Vorgang abzuschließen. Diese Token laufen 14 Tage nach der Erstellung ab. Außerdem benötigen Sie die Domain des Kunden. oder Cloud Identity-ID.

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

So übertragen Sie Berechtigungen:

Wenn Sie nur die Domain des Kunden haben, können Sie die Cloud Channel API verwenden, um Cloud Identity-ID zurückgeben. Anruf checkCloudIdentityAccountsExist durch die Domain des Kunden ersetzen. Wenn die Domain vorhanden ist, gibt die API den Fehlercode Cloud Identity-ID des Kunden.

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

Rufen Sie mit der Cloud Identity-ID des Kunden listTransferableSkus um eine Liste mit den Lifetime-Werten transferableSku Wählen Sie jeweils ein Häkchen transferEligibility des Objekts damit du die entsprechende 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 nun eine Liste der TransferableSkus haben, müssen Sie ermitteln, Rechnungskonto zur Zahlung der Ansprüche. Verwenden Sie die Methode queryEligibleBillingAccounts-Methode zum Ermitteln eines Rechnungskontos, das können jeweils für eine TransferableSku.

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 Artikelnummer mehrere Google Workspace-Rechnungskonten gibt können Sie eines der Google Workspace-Rechnungskonten auswählen für jeden TransferableSku in der Gruppe.

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 alle TransferableSku- und BillingAccount-Paare listTransferableOffers Methode zum Ermitteln Verfügbar TransferableOffers . 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"
           }
         },
       }
     ],
   }

Erstellen Sie für jedes Tupel ein neues entsprechendes Entitlement-Objekt, Für die Berechtigung sind ein Angebot, ein Rechnungskonto und alle erforderlichen Parameter erforderlich. Anruf transferEntitlements 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"
}