Administrar 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 revendedor tiene una sola cuenta de facturación de Google Workspace o varias cuentas de facturación de Google Workspace. Para obtener más información sobre este tema, consulta la Guía de inicio de varias cuentas de facturación de Google Workspace.

Crear derecho

Antes de comenzar

Necesitas una configuración de Customer antes de continuar.

Para crear derechos, sigue estos pasos:

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

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.

Si deseas pagar en una moneda específica, selecciona una cuenta de facturación 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 BillingAccount seleccionados, usa el método listPurchasableOffers para encontrar los PurchasableOffer disponibles.

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á Entitlement y la PurchasableOffer. Comienza a crear el derecho con el método create.

Crea un Entitlement y propaga la oferta, la cuenta de facturación 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, debes seguir 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 de Sku en ella.

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 Customer y Sku, usa el método queryEligibleBilling Accounts para encontrar un conjunto de BillingAccount que se pueda usar para pagar esta autorización. 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. La BillingAccount no es necesaria si la autorización 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"
        }
      },
    }
  ],
}

En este punto, deberías tener el derecho, la oferta y la cuenta de facturación. 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"
}

Actualizar o cambiar 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 pueden usar para realizar una actualización o cambiar a una versión inferior.

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 Billing Accounts que se pueda usar para pagar el derecho.

Si deseas pagar en una moneda específica, selecciona una cuenta de facturación 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 derecho, la PurchasableOffer y la 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 cuenta de facturación 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"
   }
   ```

Transferir derechos

En esta sección, encontrarás ayuda para transferir los derechos de los clientes existentes de Google Workspace y Chrome de sus socios anteriores.

Si necesitas ayuda para transferir clientes en la Partner Sales Console, consulta nuestras guías para transferir clientes a una cuenta de socio o una Cuenta de Google

Los clientes de Google Workspace solo pueden comprar derechos de un único socio o de 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 para el plan de compromiso, estos comenzarán 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 generado por el cliente. Comunícate con el cliente y proporciónale 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 dominio del cliente o el ID de Cloud Identity.

Cuando el cliente crea su token de transferencia, selecciona las autorizaciones 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 mostrar 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.

Comienza la transferencia con 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 los transferableSku del cliente. Revisa el transferEligibility de cada objeto para asegurarte de que puedes 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 pueda usarse 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 SKU que te informa qué TransferableSkus debe 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"
           }
         }
       ]
     }
   ]
 }
 ```

Para cada par de TransferableSku y BillingAccount, usa el método listTransferableOffers a fin de encontrar TransferableOffers disponible. En este punto, deberías tener la lista de tuplas del cliente, compuesta por TransferableSku, Billing Accounts 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 Entitlement correspondiente, cada uno de ellos necesita una oferta, una cuenta de facturación y los parámetros obligatorios. 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"
}