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 Cloud Marketplace gekauft hat.

In diesem Dokument wird beschrieben, wie Sie Berechtigungen für Ihre privaten Angebote über das Producer Portal und die Partner Procurement API verwalten können. Sie können die Partner Procurement API verwenden, um Angebotsberechtigungen zu genehmigen. Für andere Aufgaben zur Verwaltung von Berechtigungen für Angebote müssen Sie die Partner Procurement API verwenden.

lesen.

Berechtigungen über das Producer Portal genehmigen

Mit der Partner Procurement API können Sie Berechtigungen für private Angebote genehmigen. So genehmigen Sie eine Berechtigung:

  1. Rufen Sie in 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": "...",
  "newPendingOfferDuration": "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 die Dauer in der Nachricht in Jahren und Monaten angezeigt und das Feld newOfferEndTime ist leer. Wenn das Angebot mit einer bestimmten Endzeit erstellt wurde, wird in der Nachricht die Endzeit des Angebots angezeigt und das Feld newPendingOfferDuration 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",
  "newPendingPlan": "ultimate",   // New plan for the offer,
  "newPendingOffer": "OFFER2",    // New offer,
  "updateTime": "...",
  "newPendingOfferDuration": "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",
  "newPendingOfferDuration": "P2Y",
  "newOfferEndTime": "",
  ...
}

Sonstige Berechtigungsaufgaben beenden

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