Gestire i diritti per le offerte private con l'approvazione automatica delle offerte

Quando un cliente acquista un'offerta privata, Google crea un diritto, che indica che il cliente ha acquistato l'offerta da Cloud Marketplace.

Questo documento esamina come gestire i diritti per le tue offerte private con l'approvazione automatica delle offerte attivata utilizzando l'API Partner Procurement.

Se non hai attivato l'approvazione automatica dell'offerta per il tuo prodotto Software as a Service (SaaS), ricevi messaggi Pub/Sub diversi da quelli descritti in questo documento. Per i dettagli di questi messaggi Pub/Sub, consulta Gestire i diritti per le offerte private.

Per informazioni dettagliate sull'utilizzo dell'API Partner Procurement per le offerte private, consulta la documentazione di riferimento.

Verificare quando le offerte del cliente diventeranno attive

Quando attivi l'approvazione automatica delle offerte per un prodotto SaaS, ricevi messaggi Pub/Sub diversi da quelli che ricevi per i prodotti SaaS per cui l'approvazione automatica non è attivata. Poiché i prodotti SaaS con approvazione automatica delle offerte supportano le date di inizio pianificate, dopo l'accettazione di un'offerta privata, devi verificare quando è previsto l'inizio dell'offerta, in modo da poter eseguire il provisioning delle risorse al momento giusto.

Quando un cliente acquista un'offerta privata, Cloud Marketplace crea un diritto e invia il seguente messaggio Pub/Sub al tuo prodotto:

{
  "eventId": "...",
  "eventType": "ENTITLEMENT_OFFER_ACCEPTED",
  "entitlement": {
  "id": "ENTITLEMENT_ID",
  "updateTime": "...",
  "newPendingOfferDuration": "", // Contract duration for the offer
  "newOfferStartTime": "...", // Starting time for the offer
  "newOfferEndTime": "...", // Ending time for the offer
  },
}

In questo esempio, ENTITLEMENT_ID è un ID creato da Cloud Marketplace. I campi newOfferStartTime e newOfferEndTime sono formattati come timestamp RFC 3339 in UTC, ad esempio "2022-01-01T00:00:00Z". Se utilizzi l'API Partner Procurement per recuperare il diritto, la risposta dell'API include anche questi campi newOfferStartTime e newOfferEndTime.

Nel tuo sistema, aggiorna l'account dell'utente per indicare che ha acquistato l'offerta. Utilizza il campo newOfferStartTime per verificare l'ora in cui è previsto l'inizio dell'offerta, in modo da poter eseguire il provisioning delle risorse in base alle necessità.

Quando l'offerta raggiunge la data di inizio e diventa attiva, ricevi un ulteriore messaggio Pub/Sub con un eventType di ENTITLEMENT_ACTIVE.

Passaggi successivi