Gestionar derechos de ofertas privadas

Cuando un cliente compra una oferta privada, Google crea un derecho, que indica que el cliente ha comprado la oferta en Cloud Marketplace.

En este documento se explica cómo gestionar los derechos de tus ofertas privadas mediante Producer Portal y la API Partner Procurement. Puedes usar el portal del productor para aprobar los derechos de las ofertas. Para otras tareas de gestión de derechos de ofertas, debe usar la API Partner Procurement.

Aprobar derechos mediante Producer Portal

Puede usar Producer Portal para aprobar derechos de ofertas privadas. Para aprobar un derecho mediante el Portal del productor, sigue estos pasos:

  1. En Producer Portal, ve a la página Ofertas privadas.

  2. Haz clic en Gestionar tus ofertas.

Gestionar derechos con la API Partner Procurement

En las siguientes secciones se describe cómo gestionar los derechos de ofertas privadas mediante la API Partner Procurement.

Para obtener información sobre cómo usar la API Partner Procurement para ofertas privadas, consulta la documentación de referencia.

Aprobar un derecho

Cuando un cliente compra una oferta privada, Cloud Marketplace crea un derecho y envía el siguiente mensaje de Pub/Sub a tu producto:

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

En este ejemplo, ENTITLEMENT_ID es un ID creado por Cloud Marketplace.

Si la oferta se ha creado con una duración, el mensaje muestra la duración en años y meses, y el campo newOfferEndTime está vacío. Si la oferta se ha creado con una hora de finalización específica, el mensaje muestra la hora de finalización de la oferta y el campo newOfferDuration está vacío.

En tu sistema, actualiza la cuenta del usuario para reflejar que ha comprado la oferta. A continuación, para aprobar el derecho, haz una solicitud HTTP POST a la API Partner Procurement y envía el ENTITLEMENT_ID que quieras aprobar:

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

Rechazar un derecho

Para rechazar un derecho, usa el método reject en tu solicitud HTTP POST:

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

Sustituir una oferta activa

En función de cómo configures tu oferta privada, es posible que tu cliente pueda sustituirla. Si un cliente selecciona una nueva oferta privada, recibirás un mensaje de Pub/Sub con el siguiente formato:

{
  "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
  },
}

En este ejemplo, OFFER2 es la oferta de sustitución y ENTITLEMENT_ID es un ID creado por Cloud Marketplace. La duración de la oferta se indica en años y meses.

Para aprobar la sustitución de la oferta, haz la siguiente solicitud HTTP POST a la API Partner Procurement:

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

El cuerpo de la solicitud debe incluir el plan de la oferta que se va a aprobar:

{
  "pendingPlanName": PLAN_NAME
}

Una vez que se apruebe el cambio, recibirás otro mensaje de Pub/Sub cuando se aplique. En el mensaje, el campo eventType cambia a ENTITLEMENT_PLAN_CHANGED. Para comprobar el estado de un plan, haz la siguiente solicitud HTTP GET a la API Partner Procurement:

GET v1/providers/YOUR_PARTNER_ID/entitlements/ENTITLEMENT_ID

La respuesta es similar a la siguiente, con el campo "state" que indica si la nueva oferta está activa o si el cambio de oferta aún está pendiente:

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

Completar otras tareas de derechos

Para otras tareas de derechos que no sean específicas de las ofertas privadas, consulta la documentación pública de Cloud Marketplace:

Lista de tipos de eventos de tareas de cuentas de ofertas privadas

En la siguiente tabla se incluyen los eventTypes que puede recibir tu producto en los mensajes de Pub/Sub de ofertas privadas.

Para ver la lista completa, consulta Lista de tipos de eventos de tareas de cuentas.

eventType Descripción
ENTITLEMENT_OFFER_ENDED Indica que la oferta privada de un cliente ha finalizado. La oferta activa un evento de ENTITLEMENT_CANCELLED o permanece activa con precios sin descuento.

Siguientes pasos