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 Artikel wird beschrieben, wie Sie Berechtigungen für Ihre privaten Angebote verwalten. Verwenden Sie dazu die Partner Procurement API.

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

Berechtigung genehmigen

Wenn ein Kunde ein privates Angebot kauft, erstellt Cloud Marketplace ein Berechtigung und sendet die folgende Pub/Sub-Nachricht an das 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 die Dauer in der Meldung Jahre und Monate und das Feld newOfferEndTime ist leer. Bisheriges Angebot das zu einer bestimmten Endzeit erstellt wurde, wird in der Nachricht das Ende des Angebots und das Feld newOfferDuration ist leer.

Aktualisieren Sie in Ihrem System das Konto des Nutzers, um anzugeben, dass er den zu bieten. 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

Verwende die reject-Methode in deiner HTTP POST-Anfrage, um eine Berechtigung abzulehnen:

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. Das Angebot Die Dauer 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. So prüfen Sie den Status eines Plans: HTTP GET-Anfrage an die Partner Procurement 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": "",
  ...
}

Andere Berechtigungsaufgaben ausführen

Für andere Berechtigungsaufgaben, die nicht speziell für private Angebote gelten, findest du im Abschnitt Öffentliche Dokumentation zu Cloud Marketplace:

Liste der Ereignistypen für Kontoaufgaben privater Angebote

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

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 ein ENTITLEMENT_CANCELLED-Ereignis aus oder bleibt aktiv mit nicht rabattierten Preisen.

Nächste Schritte