Se usó la API de Cloud Translation para traducir esta página.

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

Necesitas un Customer configuración antes de continuar.

Para crear un derecho, 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 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 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"
        }
      },
    }
  ],
}

En este punto, ya deberías tener la cuenta de facturación que pagará por el Entitlement y PurchasableOffer. Comienza a crear el derecho con el método create.

Crea un Entitlement y propaga la oferta, billingAccount y cualquier otros parámetros obligatorios.

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

Derechos de Google Workspace con una prueba gratuita o de prueba pago plan no tienen un Cuenta de facturación de Google Workspace. Para cambiar el plan de pagos de una Derecho a un plan de pagos pagado, debes seguir algunos pasos adicionales selecciona una cuenta de facturación de Google Workspace.

Para cambiar el plan de pagos en los derechos de Google Workspace, sigue estos pasos: pasos:

Los primeros dos pasos solo son obligatorios si el derecho existente tiene un o un plan de pagos de prueba.

Con la oferta, utiliza el lookupOffer método para encontrar información de Sku en 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 la sku, usa el método queryEligibleBillingAccounts para encontrar un conjunto de BillingAccount que se pueda usar para pagar este derecho. Si quieres pagar en una moneda específica, selecciona una Cuenta de facturación con 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, la el campo purchase_option debe 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 mediante el 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: 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 busca un conjunto de BillingAccount que se pueden 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 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 ayudará a transferir los derechos de los Los clientes de Google Workspace y Chrome de su experiencia socio.

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 desde un solo de Google, o un solo socio.

Durante la transferencia, se cancelan automáticamente los derechos existentes antes de se volverán a crear con el nuevo socio. 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 archivo token de transferencia. 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 necesita enviarte su 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 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 mostrar su ID de Cloud Identity. Llamada checkCloudIdentityAccountsExist con el dominio del cliente y, si el dominio existe, la API devolverá ID de Cloud Identity del cliente.

Comienza la transferencia con el customers.import para importar los datos del cliente.
```
ImportCustomerRequest
{
  "parent": "accounts/abc",
  "domain": "domain"
}
```

Con el ID de Cloud Identity del cliente, llama listTransferableSkus para recuperar una lista de las cuentas transferableSku Verifica cada transferEligibility del objeto para asegurarse de que puede 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 para pagar los derechos. Usa el queryEligibleBillingAccounts para encontrar un conjunto de BillingAccount que de los usarse para cada TransferableSku.

Ten en cuenta que ciertos TransferableSkus deben compartir la misma cuenta de Google Workspace. cuenta de facturación por lo que queryEligibleBillingAccounts devuelve un grupo de SKU que te informa qué TransferableSkus debe usar la misma cuenta de facturación. Si hay varias cuentas de facturación de Google Workspace para un SKU determinado puedes elegir una de las cuentas de facturación de Google Workspace y usar 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 TransferableSku y BillingAccount, usa el listTransferableOffers método para encontrar disponible TransferableOffers de Google Cloud. En este punto, la lista de tuplas del cliente debería constar de TransferableSku, BillingCuentas 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"
}