Berechtigungen für private Angebote verwalten

Wenn ein Kunde ein privates Angebot kauft, erstellt Google eine Berechtigung, die angibt, dass der Kunde das Angebot über den Cloud Marketplace gekauft hat.

In diesem Dokument wird beschrieben, wie du Berechtigungen für deine privaten Angebote mit dem Producer Portal und der Partner Procurement API verwalten kannst. Du kannst Angebotsberechtigungen im Producer Portal genehmigen. Für andere Aufgaben zur Verwaltung von Angebotsberechtigungen müssen Sie die Partner Procurement API verwenden.

Berechtigungen über das Producer Portal genehmigen

Im Producer Portal kannst du Berechtigungen für private Angebote genehmigen. So genehmigst du eine Berechtigung über das Producer Portal:

  1. Rufen Sie im Producer Portal die Seite Private Angebote auf.

  2. Klicken Sie auf Angebote verwalten.

Berechtigungen mit der Partner Procurement API verwalten

In den folgenden Abschnitten wird beschrieben, wie Sie Berechtigungen für private Angebote mit der Partner Procurement API verwalten.

Weitere Informationen zur Verwendung der Partner Procurement API für private Angebote finden Sie in der Referenzdokumentation.

Berechtigung genehmigen

Wenn ein Kunde ein privates Angebot kauft, erstellt Cloud Marketplace eine Berechtigung und sendet die folgende Pub/Sub-Nachricht an Ihr Produkt:

{
  "eventId": "...",
  "eventType": "ENTITLEMENT_CREATION_REQUESTED",
  "entitlement": {
  "id": "ENTITLEMENT_ID",
  "updateTime": "...",
  "newOfferDuration": "P1Y6M", // Contract duration for the offer
  "newOfferEndTime": "", // Ending time for the offer
  },
}

In diesem Beispiel ist ENTITLEMENT_ID eine vom Cloud Marketplace erstellte ID.

Wenn das Angebot mit einer Dauer erstellt wurde, wird in der Meldung die Dauer in Jahren und Monaten angezeigt und das Feld newOfferEndTime ist leer. Wenn das Angebot mit einem Endzeitpunkt erstellt wurde, wird in der Meldung der Endzeitpunkt des Angebots angezeigt und das Feld newOfferDuration ist leer.

Aktualisieren Sie in Ihrem System das Konto des Nutzers, um anzuzeigen, dass er das Angebot erworben hat. Senden Sie zum Genehmigen der Berechtigung eine HTTP POST-Anfrage an die Partnerbeschaffungs-API und senden Sie die ENTITLEMENT_ID, die Sie genehmigen:

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:approve

Berechtigung ablehnen

Wenn Sie eine Berechtigung ablehnen möchten, verwenden Sie die Methode reject in Ihrer HTTP POST-Anfrage:

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:reject

Aktives Angebot ersetzen

Je nachdem, wie Sie Ihr privates Angebot eingerichtet haben, kann Ihr Kunde sein Angebot möglicherweise ersetzen. Wenn ein Kunde ein neues privates Angebot auswählt, erhalten Sie eine Pub/Sub-Nachricht im folgenden Format:

{
  "eventId": "...",
  "eventType": "ENTITLEMENT_PLAN_CHANGE_REQUESTED",
  "entitlement": {
  "id": "ENTITLEMENT_ID",
  "newPlan": "ultimate",   // New plan for the offer,
  "newOffer": "OFFER2",    // New offer,
  "updateTime": "...",
  "newOfferDuration": "P2Y",   // Contract duration for the new offer
  },
}

In diesem Beispiel ist OFFER2 das Ersatzangebot und ENTITLEMENT_ID eine vom Cloud Marketplace erstellte ID. Die Angebotsdauer wird in Jahren und Monaten angegeben.

Stellen Sie zum Genehmigen der Angebotsersetzung die folgende HTTP POST-Anfrage an die Partnerbeschaffungs-API:

POST v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID:approvePlanChange

Die Antragsstelle muss den Tarif für das genehmigte Angebot haben:

{
  "pendingPlanName": PLAN_NAME
}

Nachdem die Änderung genehmigt wurde, erhalten Sie eine weitere Pub/Sub-Nachricht, sobald die Änderung wirksam wird. In der Nachricht ändert sich das Feld eventType in ENTITLEMENT_PLAN_CHANGED. Stellen Sie zum Prüfen des Status eines Tarifs die folgende HTTP GET-Anfrage an die Partnerbeschaffungs-API:

GET v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID

Die Antwort ähnelt der folgenden, wobei das Feld „state“ anzeigt, ob das neue Preismodell aktiv ist oder ob der Wechsel noch aussteht.

{
  "name": "providers/PARTNER_ID/entitlements/ENTITLEMENT_ID",
  "provider": "PARTNER_ID",
  "account": "USER_ACCOUNT_ID",
  "product": "example-server",
  "Offer":   "OFFER1",
  "plan": "pro",
  "state": "ENTITLEMENT_PENDING_PLAN_CHANGE",
  "newPendingOffer": "OFFER2",
  "newPendingPlan": "ultimate",
  "newOfferDuration": "P2Y",
  "newOfferEndTime": "",
  ...
}

Sonstige Berechtigungsaufgaben erledigen

Weitere Berechtigungsaufgaben, die nicht speziell für private Angebote gelten, finden Sie in der öffentlichen Dokumentation zum Cloud Marketplace:

Liste der Ereignistypen für Kontoaufgaben privater Angebote

Die folgende Tabelle enthält eventTypes, die Ihr Produkt in Pub/Sub-Nachrichten für private Angebote empfangen kann.

Eine vollständige Liste finden Sie unter Liste der Ereignistypen für Kontoaufgaben.

eventType Beschreibung
ENTITLEMENT_OFFER_ENDED Zeigt an, dass das private Angebot eines Kunden beendet wurde. Das Angebot löst entweder ein ENTITLEMENT_CANCELLED-Ereignis aus oder bleibt mit nicht rabattierten Preisen aktiv.

Nächste Schritte