Administra los derechos de Google Workspace y Google Chrome

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:

  1. Con el nombre del cliente, llama a listPurchasableSkus para recuperar una lista de PurchasableSkus.

    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",
            },
          }
        }
      ]
    }
    
  2. Con el PurchasableSku seleccionado, usa el método queryEligibleBillingAccounts para encontrar un conjunto de BillingAccount de Google Workspace que se pueda usar para pagar el derecho.

    1. 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"
              }
            }
          ]
        }
      ]
    }
    
  3. Con el PurchasableSku y la BillingAccount seleccionados, usa el método listPurchasableOffers para encontrar el PurchasableOffer 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"
            }
          },
        }
      ],
    }
    
  4. En este punto, deberías tener la BillingAccount que pagará la Entitlement y la PurchasableOffer. Comienza a crear el derecho con el método create.

    1. 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.

  1. Con la oferta, usa el método lookupOffer para encontrar información de Sku 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",
       }
    }
    
  2. 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"
               }
             }
           ]
         }
       ]
     }
     ```
    
  3. 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 ser changeOfferPurchase.

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

  1. 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",
            },
          }
        }
      ]
    }
    
  2. Con PurchasableSku, usa el método queryEligibleBillingAccounts para encontrar un conjunto de BillingAccounts que se pueda usar para pagar el derecho.

    1. 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"
               }
             }
           ]
         }
       ]
     }
     ```
    
  3. 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"
              }
            },
          }
        ],
      }
      ```
    
  4. 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.

    1. 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.

  1. Para comenzar la transferencia, usa el método customers.import para importar los datos del cliente.

    ImportCustomerRequest
    {
      "parent": "accounts/abc",
      "domain": "domain"
    }
    
  2. Con el ID de Cloud Identity del cliente, llama a listTransferableSkus para recuperar una lista de sus transferableSku. Verifica el transferEligibility 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",
          },
        }
      ],
    }
    
  3. 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.

    1. 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"
               }
             }
           ]
         }
       ]
     }
     ```
    
  4. Para cada par de TransferableSku y BillingAccount, usa el método listTransferableOffers para encontrar el TransferableOffers 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"
               }
             },
           }
         ],
       }
    
  5. 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"
    }