Berechtigungen für Private Offers verwalten

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

In diesem Artikel wird beschrieben, wie Sie Berechtigungen für Ihre Private Offers mithilfe 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 von Cloud Marketplace erstellte ID.

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

Aktualisieren Sie in Ihrem System das Konto des Nutzers, um anzugeben, dass er das Angebot gekauft 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

Verwenden Sie zum Ablehnen einer Berechtigung die Methode reject in der 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. Senden Sie die folgende HTTP GET-Anfrage an die Partner Procurement API, um den Status eines Tarifs zu prüfen:

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

Weitere Berechtigungsaufgaben ausführen

Informationen zu anderen Berechtigungsaufgaben, die nicht speziell für private Angebote gelten, finden Sie in der öffentlichen Cloud Marketplace-Dokumentation:

Liste der Ereignistypen für Kontoaufgaben privater Angebote

Die folgende Tabelle enthält eventTypes, die Ihr Produkt möglicherweise in Pub/Sub-Nachrichten für private Angebote erhält.

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 einem nicht rabattierten Preis aktiv.

Nächste Schritte