En esta página, se describe cómo administrar los derechos de los clientes para los productos de Google Workspace y Google Chrome.
Requisitos previos
Antes de continuar, determina si tu cuenta de distribuidor tiene una sola cuenta de facturación de Google Workspace o varias. Para obtener más información sobre este tema, consulta la Guía de inicio para varias cuentas de facturación de Google Workspace.
Crear derecho
Antes de comenzar
Debes configurar Customer
para poder continuar.
Para crear derechos, sigue estos pasos:
Con el nombre del cliente, llama a
listPurchasableSkus
para recuperar una lista dePurchasableSkus
.ListPurchasableSkusRequest { "customer": "accounts/123/customers/abc", "createEntitlementPurchase": { "product": "products/-" } } ListPurchasableSkusResponse { "purchasableSkus": [ { "sku": { "name": "products/product_id/skus/sku_id1", "product": { "name": "products/product_id", } } }, { "sku": { "name": "products/product_id/skus/sku_id2", "product": { "name": "products/product_id", }, } } ] }
Con el PurchasableSku seleccionado, usa el método
queryEligibleBillingAccounts
para encontrar un conjunto deBillingAccount
de Google Workspace que se pueda usar para pagar el derecho.- Si deseas pagar en una moneda específica, selecciona una BillingAccount con esa moneda.
QueryEligibleBillingAccountsRequest { "customer": "accounts/123/customers/abc", "skus": ["products/product_id/skus/sku_id1"] } QueryEligibleBillingAccountsResponse { "skuPurchaseGroups": [ { "skus": [ "products/product_id/skus/sku_id1" ], "billingAccountPurchaseInfos": [ { "billingAccount": { "name": "accounts/123/billingAccounts/billing_account_id1", "displayName": "Google_Workspace_USD_US_1", "currencyCode": "USD", "regionCode": "US" } }, { "billingAccount": { "name": "accounts/123/billingAccounts/billing_account_id2", "displayName": "Google_Workspace_CAD_CA_1", "currencyCode": "CAD", "regionCode": "CA" } } ] } ] }
Con el PurchasableSku y la BillingAccount seleccionados, usa el método
listPurchasableOffers
para encontrar elPurchasableOffer
disponible.ListPurchasableOffersRequest { "customer": "accounts/123/customers/abc", "createEntitlementPurchase": { "sku": "products/product_id/skus/sku_id1", "billingAccount": "accounts/123/billingAccounts/billing_account_id2" } } ListPurchasableOffersResponse { "purchasableOffers": [ { "offer": { "name": "accounts/123/offers/offer_id1", }, "sku": { "name": "products/product_id/skus/sku_id1", }, "plan": { "paymentPlan": "FLEXIBLE", "paymentCycle": { "duration": 1, "periodType": "MONTH" } }, } ], }
En este punto, deberías tener la BillingAccount que pagará la
Entitlement
y la PurchasableOffer. Comienza a crear el derecho con el métodocreate
.- Crea un derecho y propaga la oferta, billingAccount y cualquier otro parámetro obligatorio.
CreateEntitlementRequest { "parent": "accounts/123/customers/abc", "entitlement": { "offer": "accounts/123/offers/offer_id1", "maxUnits": 100, "billingAccount": "accounts/123/billingAccounts/billing_account_id2" } } CreateEntitlementResponse { "name": "operations/operation_id1" }
Cambia el plan de pagos en los derechos de Google Workspace
Antes de comenzar
Los derechos de Google Workspace con un pago gratuito o de prueba plan
no tienen una cuenta de facturación de Google Workspace. Para cambiar el plan de pagos de un derecho a un plan de pagos pagado, hay algunos pasos adicionales para seleccionar una cuenta de facturación de Google Workspace.
Para cambiar el plan de pagos en los derechos de Google Workspace, sigue estos pasos:
Los primeros dos pasos solo son obligatorios si el derecho existente tiene un plan de pagos gratuito o de prueba.
Con la oferta, usa el método
lookupOffer
para encontrar información deSku
sobre la oferta.LookupOfferRequest { "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1" } LookupOffer respones { "name": "accounts/123/offers/offer_id1", "sku": { "name": "products/product_id/skus/sku_id1", } }
Con el cliente y el Sku, usa el método queryEligibleBillingAccounts para encontrar un conjunto de BillingAccount que se pueda usar para pagar este derecho. Si deseas pagar en una moneda específica, selecciona una BillingAccount con esa moneda.
QueryEligibleBillingAccountsRequest { "customer": "accounts/123/customers/abc", "skus": ["products/product_id/skus/sku_id1"] } QueryEligibleBillingAccountsResponse { "skuPurchaseGroups": [ { "skus": [ "products/product_id/skus/sku_id1" ], "billingAccountPurchaseInfos": [ { "billingAccount": { "name": "accounts/123/billingAccounts/billing_account_id1", "displayName": "Google_Workspace_USD_US_1", "currencyCode": "USD", "regionCode": "US" } }, { "billingAccount": { "name": "accounts/123/billingAccounts/billing_account_id2", "displayName": "Google_Workspace_CAD_CA_1", "currencyCode": "CAD", "regionCode": "CA" } } ] } ] } ```
Con Entitlement y BillingAccount, usa el método
listPurchasableOffers
para encontrar cualquier PurchasableOffer. No se necesita BillingAccount si el derecho existente ya tiene un plan pagado. En este caso, se usará la BillingAccount existente. Para cambiar el plan de pagos, el campo purchase_option debe serchangeOfferPurchase
.ListPurchasableOffersRequest { "customer": "accounts/123/customers/abc", "changeOfferPurchase": { "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1", "billingAccount": "accounts/123/billingAccounts/billing_account_id2" } } ListPurchasableOffersResponse { "purchasableOffers": [ { "offer": { "name": "accounts/123/offers/offer_id1", }, "sku": { "name": "products/product_id/skus/sku_id1", }, "plan": { "paymentPlan": "FLEXIBLE", "paymentCycle": { "duration": 1, "periodType": "MONTH" } }, } ], }
En este punto, deberías tener el derecho, la oferta y la BillingAccount. Comienza a cambiar el plan de pagos con el método
changeOffer
.ChangeOfferRequest { "name": "accounts/abc/customers/123/entitlements/entitlement_id1", "offer": "accounts/abc/offers/offer_id1", "billing_account": "accounts/abc/billingAccounts/billing_account_id2", "parameters": [{ "name": "max_units", "value": { "int64Value": "100" } }] } ChangeOfferResponse { "name": "operations/operation_id1" }
Actualiza o cambia a una versión inferior los derechos de Google Workspace
Para actualizar o cambiar a una versión inferior los derechos de Google Workspace, sigue estos pasos:
Con el derecho, llama al método
listPurchasableSkus
para recuperar una lista de PurchasableSkus que se puede usar para actualizar o cambiar a una versión anterior.ListPurchasableSkusRequest { "customer": "accounts/123/customers/abc", "changeOfferPurchase": { "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1", "changeType": "UPGRADE" } } ListPurchasableSkusResponse { "purchasableSkus": [ { "sku": { "name": "products/product_id/skus/sku_id1", "product": { "name": "products/product_id", } } }, { "sku": { "name": "products/product_id/skus/sku_id2", "product": { "name": "products/product_id", }, } } ] }
Con PurchasableSku, usa el método
queryEligibleBillingAccounts
para encontrar un conjunto de BillingAccounts que se pueda usar para pagar el derecho.- Si deseas pagar en una moneda específica, selecciona una BillingAccount con esa moneda.
QueryEligibleBillingAccountsRequest { "customer": "accounts/123/customers/abc", "skus": ["products/product_id/skus/sku_id1"] } QueryEligibleBillingAccountsResponse { "skuPurchaseGroups": [ { "skus": [ "products/product_id/skus/sku_id1" ], "billingAccountPurchaseInfos": [ { "billingAccount": { "name": "accounts/123/billingAccounts/billing_account_id1", "displayName": "Google_Workspace_USD_US_1", "currencyCode": "USD", "regionCode": "US" } }, { "billingAccount": { "name": "accounts/123/billingAccounts/billing_account_id2", "displayName": "Google_Workspace_CAD_CA_1", "currencyCode": "CAD", "regionCode": "CA" } } ] } ] } ```
Con Entitlement y BillingAccount, usa el método
listPurchasableOffers
para encontrar cualquier PurchasableOffer.ListPurchasableOffersRequest { "customer": "accounts/123/customers/abc", "changeOfferPurchase": { "entitlement": "accounts/123/customers/abc/entitlements/entitlement_id1", "billingAccount": "accounts/123/billingAccounts/billing_account_id2" } } ListPurchasableOffersResponse { "purchasableOffers": [ { "offer": { "name": "accounts/123/offers/offer_id1", }, "sku": { "name": "products/product_id/skus/sku_id1", }, "plan": { "paymentPlan": "FLEXIBLE", "paymentCycle": { "duration": 1, "periodType": "MONTH" } }, } ], } ```
En este punto, deberías tener el Entitlement, PurchasableOffer y BillingAccount. Comienza a actualizar o cambiar a una versión inferior con el método
changeOffer
.- Crea un objeto Entitlement y propaga el nombre, la oferta, la billingAccount y los parámetros obligatorios.
ChangeOfferRequest { "name": "accounts/abc/customers/123/entitlements/entitlement_id1", "offer": "accounts/abc/offers/offer_id1", "billing_account": "accounts/abc/billingAccounts/billing_account_id2", "parameters": [{ "name": "max_units", "value": { "int64Value": "100" } }] } ChangeOfferResponse { "name": "operations/operation_id1" } ```
Cómo transferir derechos
Esta sección te ayuda a transferir los derechos de los clientes existentes de Google Workspace y Chrome de su socio anterior.
Si necesitas ayuda para transferir clientes en Partner Sales Console, consulta nuestras guías sobre cómo transferir clientes a una cuenta de socio o a una cuenta de Google.
Los clientes de Google Workspace solo pueden comprar derechos a un solo socio o a un solo socio y Google.
Durante la transferencia, los derechos existentes se cancelan automáticamente antes de que se vuelvan a crear con el socio nuevo. Si un cliente tiene derechos de plan de compromiso, comenzará un nuevo plazo de compromiso después de la transferencia.
Antes de comenzar
Para administrar los derechos de un cliente, necesitas un token de transferencia que genere el cliente. Comunícate con el cliente y proporciona tu Identificador público de socio para que pueda generar un token de transferencia. Después de crear un token, el cliente debe enviarte el token de transferencia para completar el proceso. Estos tokens vencen 14 días después de su creación. También necesitas el ID de Cloud Identity o el dominio del cliente.
Cuando el cliente crea su token de transferencia, selecciona los derechos que desea transferir a su nuevo distribuidor. Debes transferir todos los derechos seleccionados durante el proceso.
Para transferir derechos, sigue estos pasos:
Si solo tienes el dominio del cliente, puedes usar la API de Cloud Channel para
recuperar su ID de Cloud Identity. Llama a checkCloudIdentityAccountsExist
con el dominio del cliente y, si el dominio existe, la API mostrará el ID de Cloud Identity del cliente.
Para comenzar la transferencia, usa el método
customers.import
para importar los datos del cliente.ImportCustomerRequest { "parent": "accounts/abc", "domain": "domain" }
Con el ID de Cloud Identity del cliente, llama a
listTransferableSkus
para recuperar una lista de sustransferableSku
. Verifica eltransferEligibility
de cada objeto para asegurarte de poder comprar el SKU asociado.ListTransferableSkusRequest { "parent": "accounts/abc", "cloudIdentityId": "cloud_identity_id" } ListTransferableSkusResponse { "transferableSku": [ { "sku": { "name": "products/product_id/skus/voice_sku_id1", }, }, { "sku": { "name": "products/product_id/skus/google_workspace_sku_id2", }, }, { "sku": { "name": "products/product_id/skus/google_workspace_chrome_sku_id3", }, } ], }
Ahora que tienes una lista de TransferableSkus, debes determinar qué BillingAccount usar para pagar los derechos. Usa el método
queryEligibleBillingAccounts
para encontrar un conjunto de BillingAccount que se pueda usar para cada TransferableSku.- Ten en cuenta que ciertos TransferableSkus deben compartir la misma cuenta de facturación de Google Workspace, por lo que
queryEligibleBillingAccounts
muestra un grupo de skus que te informa qué TransferableSkus deben usar la misma BillingAccount. Si hay varias cuentas de facturación de Google Workspace para un grupo de SKU determinado, puedes elegir una de ellas y usarla para cada TransferableSku del grupo.
QueryEligibleBillingAccountsRequest { "customer": "accounts/123/customers/abc", "skus": ["products/product_id/skus/voice_sku_id1","products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3"] } QueryEligibleBillingAccountsResponse { "skuPurchaseGroups": [ { "skus": [ "products/product_id/skus/voice_sku_id1" ], "billingAccountPurchaseInfos": [ { "billingAccount": { "name": "accounts/123/billingAccounts/voice_billing_account_id1", "displayName": "Google_Workspace_Voice_USD_US_1", "currencyCode": "USD", "regionCode": "US" } } ] }, { "skus": [ "products/product_id/skus/google_workspace_sku_id2","google_workspace_chrome_sku_id3" ], "billingAccountPurchaseInfos": [ { "billingAccount": { "name": "accounts/123/billingAccounts/gw_billing_account_id1", "displayName": "Google_Workspace_USD_US_1", "currencyCode": "USD", "regionCode": "US" } }, { "billingAccount": { "name": "accounts/123/billingAccounts/gw_billing_account_id2", "displayName": "Google_Workspace_CAD_CA_1", "currencyCode": "CAD", "regionCode": "CA" } } ] } ] } ```
- Ten en cuenta que ciertos TransferableSkus deben compartir la misma cuenta de facturación de Google Workspace, por lo que
Para cada par de TransferableSku y BillingAccount, usa el método
listTransferableOffers
para encontrar elTransferableOffers
disponible. En este punto, deberías tener la lista de tuplas del cliente que consta de TransferableSku, BillingAccounts y TransferableOffer.ListTransferableOffersRequest { "parent": "accounts/abc", "cloudIdentityId": "cloud_identity_id", "sku": "products/product_id/skus/voice_sku_id1", "billingAccount": "ccounts/123/billingAccounts/voice_billing_account_id1" } ListTransferableOffersResponse { "transferableOffers": [ { "offer": { "name": "accounts/123/offers/voice_offer_id1", }, "sku": { "name": "products/product_id/skus/voice_sku_id1", }, "plan": { "paymentPlan": "FLEXIBLE", "paymentCycle": { "duration": 1, "periodType": "MONTH" } }, } ], }
Para cada tupla, crea un nuevo objeto de derechos correspondiente. Cada derecho necesita una oferta, una BillingAccount y cualquier parámetro obligatorio. Llama al método
transferEntitlements
para realizar la transferencia.TransferEntitlementsRequest { "parent": "accounts/abc/customers/123", "entitlements": [ { "offer": "accounts/123/offers/voice_offer_id1", "maxUnits": 100, "billingAccount": "accounts/123/billingAccounts/voice_billing_account_id1" }, { "offer": "accounts/123/offers/gw_offer_id2", "maxUnits": 150, "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1" } { "offer": "accounts/123/offers/gw_chrome_offer_id3", "maxUnits": 200, "billingAccount": "accounts/123/billingAccounts/gw_billing_account_id1" } ] } TransferEntitlementsResponse { "name": "operations/operation_id1" }