Criar e gerenciar ofertas privadas usando a API

A API Commerce Producer oferece acesso programático à criação e publicação de ofertas privadas para parceiros e integradores. Essa API substitui as operações manuais no Portal do Produtor, permitindo que os parceiros criem, gerenciem e publiquem ofertas privadas diretamente dos sistemas internos ou plataformas de terceiros.

Principais vantagens

  • Escala e automação: ao passar de cliques manuais no portal para o controle programático, os parceiros podem aumentar o volume de transações com mais eficiência.
  • Eficiência operacional: a integração da API reduz o atrito da mesa de negociação e ajuda a evitar erros manuais no processo de criação de ofertas.
  • Velocidade de lançamento: ao criar com base na API durante a prévia, os parceiros estão prontos para lançar assim que a disponibilidade geral for anunciada.

Público-alvo

Essa API é para parceiros estratégicos ISV e integradores do marketplace que querem automatizar a criação e o gerenciamento de ofertas privadas. Quando você lista ou recupera serviços, a API retorna todos eles. O campo productType do recurso Service identifica os seguintes tipos de produtos:

Serviços de qualquer outro tipo de produto informam um productType de PRODUCT_TYPE_UNSPECIFIED. Outros valores de productType podem ser adicionados com o tempo. Por isso, sua integração precisa processar valores não reconhecidos e mudanças no productType de um serviço atual.

Antes de começar

Antes de usar a API Commerce Producer, conclua os seguintes pré-requisitos:

  1. Ative a API Commerce Producer: ative o serviço commerceproducer.googleapis.com no seu projeto:

    gcloud services enable commerceproducer.googleapis.com
    

    Para instruções sobre como ativar serviços, consulte Como ativar serviços.

  2. Configurar bibliotecas de cliente: faça o download dos SDKs e das bibliotecas de cliente necessários. Para mais detalhes, consulte Bibliotecas de cliente.

  3. Referência da API: para acessar a referência da API, consulte a Referência da API Commerce Producer.

Fluxo padrão da API

A criação e publicação programáticas de uma oferta privada exigem uma sequência específica de chamadas de API. O fluxo padrão consiste nas seguintes etapas:

  1. Listar serviços: liste os serviços no projeto para encontrar aquele em que criar a oferta privada.
  2. Listar ofertas padrão: liste as ofertas padrão ativas no serviço selecionado para encontrar o nome do recurso da oferta padrão básica. O nome do recurso é obrigatório para criar uma oferta privada.
    • Liste as ofertas padrão que não expiraram.
    • Se você encontrar várias ofertas padrão para o mesmo nível de serviço com durações diferentes, poderá selecionar qualquer uma delas. Elas são funcionalmente idênticas porque a duração da oferta privada substitui a duração da oferta padrão.
    • Só é possível usar ofertas padrão válidas e não expiradas.
  3. Descubra qual oferta alterar: ligue para resolveAmendmentTarget para saber se a nova oferta precisa alterar uma oferta atual ou não.
  4. Criar a oferta (create PrivateOffer): chame a API para criar um recurso PrivateOffer no estado DRAFT, definindo os detalhes básicos, a conta billing_name do cliente e modelos de preços personalizados.
  5. Anexar um documento (create PrivateOfferDocument ): crie um recurso PrivateOfferDocument e anexe à sua oferta em rascunho para especificar os termos ou o EULA. Cada oferta privada precisa incluir pelo menos um documento antes de ser publicada. Uma oferta privada pode ter no máximo um documento de cada tipo e não pode ter um EULA padrão e um EULA personalizado. Para verificar as regras de documentos por tipo de um serviço, inspecione o campo documentRequirement do recurso Service:
    • Para a maioria dos serviços, como SaaS e produtos de dados, documentRequirement lista STANDARD_END_USER_LICENSE_AGREEMENT_V2 (EULA padrão) e CUSTOM_END_USER_LICENSE_AGREEMENT (EULA personalizado) como OPTIONAL porque documentRequirement expressa apenas regras por tipo. Você ainda precisa anexar STANDARD_END_USER_LICENSE_AGREEMENT_V2 ou CUSTOM_END_USER_LICENSE_AGREEMENT.
    • Para serviços profissionais, a STATEMENT_OF_WORK (SOW) é REQUIRED, a CUSTOM_END_USER_LICENSE_AGREEMENT é OPTIONAL e os EULAs padrão são NOT_ALLOWED.
    • STANDARD_END_USER_LICENSE_AGREEMENT_V1 é substituído por STANDARD_END_USER_LICENSE_AGREEMENT_V2 e é sempre NOT_ALLOWED para novas ofertas.
  6. Publicar a oferta (publish): chame o método publish para finalizar a oferta e disponibilizá-la para o cliente aceitar. Use a flag validate_only para validar os detalhes da oferta sem publicá-la.

Principais termos e conceitos

  • PrivateOffer: o recurso principal que representa uma oferta personalizada estendida a um cliente específico. Ele é compatível com estados como DRAFT, PUBLISHED e ACCEPTED.
  • PrivateOfferDocument: um documento não estruturado anexado a uma oferta privada em rascunho, como um EULA padrão (STANDARD_END_USER_LICENSE_AGREEMENT_V2), um EULA personalizado (CUSTOM_END_USER_LICENSE_AGREEMENT) ou uma declaração de trabalho (STATEMENT_OF_WORK). Toda oferta privada precisa incluir pelo menos um documento antes de ser publicada. Uma oferta particular pode ter no máximo um documento de cada tipo e não pode ter um EULA padrão e um EULA personalizado. Os tipos de documentos obrigatórios, opcionais ou não permitidos dependem do campo documentRequirement do recurso Service. Observação: STANDARD_END_USER_LICENSE_AGREEMENT_V1 foi substituído e não é permitido para novas ofertas. Esses documentos são imutáveis depois que a oferta sai do estado DRAFT.
  • Service: o nome do serviço, que é um recurso somente leitura que representa um produto. Quando esse valor é definido, ele ajuda você a encontrar quais StandardOffers estão disponíveis para esse produto. Listar ou recuperar serviços retorna todos os seus serviços e inclui os seguintes campos:
    • productType: o tipo de produto comercializado pelo serviço (SOFTWARE_AS_A_SERVICE, PROFESSIONAL_SERVICES ou ANALYTICS_HUB_LISTING) ou PRODUCT_TYPE_UNSPECIFIED para qualquer outro tipo de produto.
    • documentRequirement: os níveis de requisitos por tipo (REQUIRED, OPTIONAL ou NOT_ALLOWED) para documentos anexados a ofertas particulares no serviço. Um tipo de documento que não está listado não é permitido. Como documentRequirement expressa apenas regras por tipo, ele lista STANDARD_END_USER_LICENSE_AGREEMENT_V2 e CUSTOM_END_USER_LICENSE_AGREEMENT como OPTIONAL para serviços em que é necessário anexar um desses dois tipos de EULA.
  • Sku: uma unidade de manutenção de estoque (SKU) que representa a unidade atômica de preços e faturamento. Cada cobrança ao cliente está associada e tem origem em exatamente uma SKU.
  • SkuGroup: um recurso que representa um grupo de SKUs.
  • StandardOffer: quando um Service é selecionado, isso permite determinar qual nível de serviço usar para criar ofertas particulares. As ofertas padrão precisam estar válidas e não expiradas para serem usadas como uma oferta padrão de base.

Bibliotecas de cliente

Use as bibliotecas de cliente Google Cloud para interagir com a API.

  • SDKs disponíveis: o Google oferece bibliotecas geradas automaticamente para Ruby, Java, Python, Go, C#, PHP e Node.js.
  • Download do SDK: os pacotes da biblioteca de cliente estão disponíveis no GitHub.
  • Orientação geral: para mais informações sobre o uso das bibliotecas de cliente do Google Cloud , consulte Bibliotecas de cliente do Cloud por linguagem.
  • Equivalentes de interface: para entender como essas operações são mapeadas no console doGoogle Cloud , leia Criar uma oferta privada para um cliente.

Limitações

A API tem as seguintes limitações:

  • Visibilidade da interface para rascunhos: as ofertas criadas ou atualizadas usando a API não ficam visíveis nem podem ser editadas na interface do portal do produtor até que sejam publicadas. Da mesma forma, se você criar uma oferta no Portal do Produtor, mas a modificar usando a API, não será possível visualizar ou mudar o rascunho no Portal do Produtor.

Papéis e permissões

Para interagir com a API Commerce Producer, você precisa ter os seguintes papéis do Identity and Access Management (IAM) no projeto do produtor:

  • Para ações de leitura e gravação: roles/commerceproducer.admin ou roles/commercepricemanagement.privateOffersAdmin
    • Como alternativa, o papel básico roles/editor também concede acesso.
  • Para ações somente leitura: roles/commerceproducer.viewer ou roles/commercepricemanagement.viewer
    • Como alternativa, o papel básico roles/viewer também concede acesso.

Configurar preços e programações

Use as configurações a seguir para definir modelos de preços e programações de horários para suas ofertas particulares.

Configurar modelos de preços

Para configurar diferentes modelos de preços, defina os campos no recurso PrivateOffer conforme descrito nos exemplos a seguir:

  • Taxa fixa, cobrança mensal de US $100, com um desconto de 20% no uso:
    • standard_interval_price.standard_interval: MONTHLY_NOT_PRORATED
    • standard_interval_price.price_model.flat_fee.flat_fee_override: 100 (USD)
    • standard_interval_price.price_model.usage.default_discount_percent: 20
  • Somente uso, desconto de 20% no uso:
    • standard_interval_price.standard_interval: STANDARD_INTERVAL_UNSPECIFIED
    • standard_interval_price.price_model.usage.default_discount_percent: 20
  • Desconto por compromisso de uso (CUD) com um desconto de uso padrão de 30% (a cobrança trimestral é de US $100 e o crédito trimestral é de US $100; o desconto se aplica ao uso) e um desconto personalizado de 40% na SKU1, compromisso trimestral, com transferência de crédito (os créditos não utilizados do trimestre anterior são transferidos para o próximo trimestre):
    • standard_interval_price.standard_interval: QUARTERLY_NOT_PRORATED
    • standard_interval_price .price_model.commitment.commitment_amount: 100 (USD)
    • standard_interval_price .price_model.commitment.discard_previous_credit_balance: false (não descarte o saldo anterior para permitir a transferência de crédito)
    • standard_interval_price.price_model.usage.default_discount_percent: 30
    • standard_interval_price .price_model.usage.sku_discounts[0].sku: SKU1 (seleciona SKU1 para aplicar um desconto personalizado)
    • standard_interval_price .price_model.usage.sku_discounts[0].discount_percent: 40 (especifica um desconto de 40% em SKU1 para substituir o desconto padrão de 30%)
  • CUD com compromisso mensal de US $100, desconto de 20% na assinatura (o cliente paga uma taxa mensal de US $80 e recebe um crédito mensal de US $100), sem transferência de crédito (os créditos não utilizados do mês anterior não são transferidos para o mês seguinte):
    • standard_interval_price.standard_interval: MONTHLY_NOT_PRORATED
    • standard_interval_price .price_model.commitment.commitment_amount: 100 (USD)
    • standard_interval_price.price_model.commitment.discount_percent: 20
    • standard_interval_price .price_model.commitment.discard_previous_credit_balance: true (descarte o saldo anterior para evitar a transferência de crédito)
  • Parcelas personalizadas: use custom_interval_price.installments. As regras para modelos de taxa fixa e CUD ainda se aplicam.
  • Três parcelas (exemplo):
    • Parcela 1: compromisso de US$ 100, desconto de 20% (o cliente paga US $80), crédito adicional de US$ 25 (totalizando US $125).
      • custom_interval_price .installments[0].price_model.commitment.commitment_amount: 100
      • custom_interval_price .installments[0].price_model.commitment.discount_percent: 20
      • custom_interval_price .installments[0].price_model.commitment.additional_credit: 25
      • custom_interval_price .installments[0].price_model.commitment .discard_previous_credit_balance: true ou false (os créditos não utilizados ainda não existem porque esta é a primeira parcela).
    • Parcela 2: compromisso de US$ 200, desconto de 10% (o cliente paga US $180), crédito adicional de US$ 25 (totalizando US $225). Os créditos não usados da parcela 1 não serão transferidos para a parcela 2.
      • custom_interval_price .installments[1].price_model.commitment.commitment_amount: 200
      • custom_interval_price .installments[1].price_model.commitment.discount_percent: 10
      • custom_interval_price .installments[1].price_model.commitment.additional_credit: 25
      • custom_interval_price .installments[1].price_model.commitment .discard_previous_credit_balance: true (descarte o saldo anterior para evitar o rollover).
    • Parcela 3: compromisso de US$ 200, desconto de 10% (o cliente paga US $180), crédito adicional de US$ 0 (total de US $200). Os créditos não usados da parcela 2 serão transferidos para a parcela 3.
      • custom_interval_price .installments[2].price_model.commitment.commitment_amount: 200
      • custom_interval_price .installments[2].price_model.commitment.discount_percent: 10
      • custom_interval_price .installments[2].price_model.commitment.additional_credit: 0
      • custom_interval_price .installments[2].price_model.commitment .discard_previous_credit_balance: false (não descarte o saldo anterior para permitir a transferência).

Configurar programações de horário

Observação: na UI, os campos que contêm "horário de início", como o horário de início da parcela, representam o início do dia. Por exemplo, se você inserir 2026-12-31, o horário de início será às 0h do fuso horário do Pacífico em 2026-12-31. Na API, você especifica 00:00 de 2026-12-31, para que as datas na UI e na API correspondam.

No entanto, os campos da UI que contêm "horário de término", como o prazo de aceitação da oferta, representam o fim do dia. Por exemplo, se você definir o prazo como 2026-12-31, o prazo efetivo será às 00h00 (horário do Pacífico) de 2027-01-01. A API mostra a data como 2027-01-01, o que significa que as datas da UI e da API não correspondem.

Para configurar diferentes programações de horário, defina os campos no recurso PrivateOffer, conforme descrito nos exemplos a seguir:

  • Oferta com início imediato e duração:
    • term.start_policy: IMMEDIATE
    • term.end_policy: AFTER_DURATION
    • term.duration_months: 12
    • Se você usar parcelas personalizadas, a primeira não poderá definir um horário de início.
  • Oferta com início imediato e término em uma data específica:
    • term.start_policy: IMMEDIATE
    • term.end_policy: SCHEDULED_END_TIME
    • term.scheduled_end_time: 2029-01-01
    • Se você usar parcelas personalizadas, a primeira não poderá definir um horário de início.
  • Oferta com início em uma data programada e duração:
    • term.start_policy: SCHEDULED_START_TIME
    • term.scheduled_start_time: 2027-01-01
    • term.end_policy: AFTER_DURATION
    • term.duration_months: 12
    • Se você usar parcelas personalizadas, o horário de início da primeira parcela precisará corresponder ao horário de início programado.
  • Oferta com início em uma data programada e término em uma data específica:
    • term.start_policy: SCHEDULED_START_TIME
    • term.scheduled_start_time: 2027-01-01
    • term.end_policy: SCHEDULED_END_TIME
    • term.scheduled_end_time: 2029-01-01
    • Se você usar parcelas personalizadas, o horário de início da primeira parcela precisará corresponder ao horário de início programado.
  • A oferta termina quando a oferta alterada termina:
    • term.end_policy: MATCH_AMENDED_OFFER
    • term.duration_months: 12 (precisa corresponder à duração da oferta alterada).

Comandos para cada etapa

Use os seguintes comandos curl para realizar cada etapa do fluxo de trabalho.

Etapa 1: listar serviços

Liste todos os serviços no projeto. Use este comando para encontrar o nome do serviço necessário para listar as ofertas padrão.

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
   "https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services"

Para recuperar a visualização completa de um único serviço, execute o seguinte comando:

curl -G -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  "https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services/SERVICE_NAME" \
  --data-urlencode 'view=SERVICE_VIEW_FULL'

Etapa 2: listar ofertas padrão

Antes de criar uma oferta particular, é necessário associá-la a uma oferta padrão definindo o campo baseStandardOffer. Para encontrar ofertas padrão ativas, liste as ofertas padrão e filtre por expire_time. Defina expire_time como "agora" para garantir que todas as ofertas padrão expiradas sejam filtradas.

curl -G -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  "https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services/SERVICE_NAME/standardOffers" \
  --data-urlencode 'filter=expire_time > "2026-05-27T11:30:00-04:00"'

Para recuperar a visualização completa de uma oferta padrão, execute o seguinte comando:

curl -G -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  "https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services/SERVICE_NAME/standardOffers/OFFER_ID" \
  --data-urlencode 'view=STANDARD_OFFER_VIEW_FULL'

Etapa 3: determinar qual oferta será alterada

Para determinar qual oferta será alterada, chame o método resolveAmendmentTarget. Dependendo da resposta, você pode definir o campo amendedPrivateOffer ou amendedStandardOffer na nova oferta.

curl -G \
  -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  "https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers:resolveAmendmentTarget" \
  --data-urlencode "targetBillingAccount=billingAccounts/CUSTOMER_BILLING_ACCOUNT" \
  --data-urlencode "baseStandardOffer=projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services/SERVICE_NAME/standardOffers/OFFER_ID"

Ao chamar resolveAmendmentTarget, você precisa fornecer os seguintes parâmetros de consulta:

  • targetBillingAccount: a conta do Cloud Billing do cliente para a qual você quer criar a oferta privada na Etapa 4.
  • baseStandardOffer: a oferta padrão básica que você selecionou na Etapa 2.

A lista a seguir descreve as respostas possíveis de resolveAmendmentTarget e como lidar com elas na Etapa 4:

  • Resposta vazia: não defina amendedPrivateOffer nem amendedStandardOffer na oferta que você criar.
  • requiredPrivateOffer: defina o campo amendedPrivateOffer da nova oferta com esse valor. Formato: projects/PROJECT/locations/global/privateOffers/PRIVATE_OFFER_ID
  • requiredStandardOffer: defina o campo amendedStandardOffer da nova oferta com esse valor. Formato: projects/PROJECT/locations/global/services/SERVICE/standardOffers/OFFER_ID
  • optionalOffers: uma lista de ofertas qualificadas que podem ser alteradas. Formato: projects/PROJECT/locations/global/privateOffers/PRIVATE_OFFER_ID

    Você pode realizar uma das seguintes ações:

    • Defina amendedPrivateOffer e amendedStandardOffer como vazios. A nova oferta não altera outra oferta.
    • Defina amendedPrivateOffer como um dos recursos da lista optionalOffers.
  • Erro 4XX: não é possível prosseguir para a etapa 4. A mensagem de erro indica o motivo. Por exemplo, isso pode acontecer quando várias assinaturas são desativadas e uma compra está pendente. Aguarde a ativação ou rejeição da compra pendente antes de continuar.

Etapa 4: criar uma oferta privada

Crie um rascunho de oferta privada. O comando a seguir cria uma oferta privada provisória com duas parcelas e início imediato. Substitua os marcadores de posição pelos detalhes da sua oferta, como datas, descontos e o ID da oferta padrão.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
  "title": "Your title",
  "acceptDeadlineTime": {
    "year": 2026,
    "month": 4,
    "day": 24,
    "timeZone": {
      "id": "America/Los_Angeles"
    }
  },
  "singleProductOffer": {
    "baseStandardOffer": "projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services/YOUR_SERVICE_NAME/standardOffers/STANDARD_OFFER_ID_FROM_EARLIER",
    "customIntervalPrice": {
      "installments": [
        {
          "priceModel": {
            "commitment": {
              "commitmentAmount": {
                "currencyCode": "USD",
                "units": 500
              },
              "discountPercent": {
                "value": "30"
              }
            }
          }
        },
        {
          "startTime": {
            "year": 2026,
            "month": 5,
            "day": 17,
            "timeZone": {
              "id": "America/Los_Angeles"
            }
          },
          "priceModel": {
            "commitment": {
              "commitmentAmount": {
                "currencyCode": "USD",
                "units": 800
              },
              "discountPercent": {
                "value": "20"
              }
            }
          }
        }
      ]
    }
  },
  "customer": {
    "entityTitle": "customer title",
    "contact": "customer contact",
    "targetBillingAccount": "billingAccounts/CUSTOMER_BILLING_ACCOUNT"
  },
  "partnerContact": {
    "contact": "partner contact",
    "email": "partner@email.com"
  },
  "term": {
    "startPolicy": "IMMEDIATE",
    "endPolicy": "AFTER_DURATION",
    "durationMonths": 2,
    "maxRenewalCount": 0
  },
  "offerDealType": "NEW"
}' \
"https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers"

Para verificar a criação, liste as ofertas privadas no seu projeto:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" "https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers"

Para listar ofertas particulares e filtrar por hora de atualização, execute o seguinte comando:

curl -G -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
  "https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers" \
  --data-urlencode 'filter=update_time > "2026-06-25T11:30:00-04:00"' \
  --data-urlencode 'orderBy=update_time desc'

Para recuperar uma oferta privada específica:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" "https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers/PRIVATE_OFFER_ID"

Para recuperar a visualização completa de uma oferta particular, que inclui campos adicionais, execute o seguinte comando:

curl -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" "https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers/PRIVATE_OFFER_ID?view=PRIVATE_OFFER_VIEW_FULL"

Etapa 5: criar um documento de oferta privada

Você precisa anexar um documento, como um EULA ou uma ordem de serviço (SOW), para publicar uma oferta privada. O comando a seguir cria e anexa um EULA padrão:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
  "documentType": "STANDARD_END_USER_LICENSE_AGREEMENT_V2"
}' \
"https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers/PRIVATE_OFFER_ID/documents"

Etapa 6: publicar a oferta privada

Publique a oferta privada para que o cliente possa aceitá-la. Substitua PRIVATE_OFFER_ID pelo ID da oferta em rascunho.

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{}' \
"https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers/PRIVATE_OFFER_ID:publish"

Exemplos de configurações de oferta privada

Os exemplos a seguir mostram como configurar diferentes tipos de ofertas particulares.

Início imediato, várias parcelas, desconto por fidelidade

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
  "singleProductOffer": {
    "baseStandardOffer": "projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services/YOUR_SERVICE_NAME/standardOffers/STANDARD_OFFER_ID",
    "customIntervalPrice": {
      "installments": [
        {
          # This installment is set to start immediately since it does not have a startTime
          "priceModel": {
            "commitment": {
              "commitmentAmount": {
                "currencyCode": "USD",
                "units": 100
              },
              "discountPercent": {
                # The discount % set here will apply to the subscription cost. In this case, customer will
                # pay $90 and get $100 in credit for this installment.
                "value": "10"
              }
            }
          }
        },
        {
          "startTime": {
            "year": 2026,
            "month": 5,
            "day": 17,
            "timeZone": {
              "id": "America/Los_Angeles"
            }
          },
          "priceModel": {
            "commitment": {
              "commitmentAmount": {
                "currencyCode": "USD",
                "units": 800
              },
              "discountPercent": {
                "value": "20"
              }
            }
          }
        }
      ]
    }
  },
  "term": {
    "startPolicy": "IMMEDIATE",
    "endPolicy": "AFTER_DURATION",
    "durationMonths": 2,
    "maxRenewalCount": 0
  }
}' \
"https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers"

Início imediato, várias parcelas, desconto por uso com substituições de métricas

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
  "singleProductOffer": {
    "baseStandardOffer": "projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services/YOUR_SERVICE_NAME/standardOffers/STANDARD_OFFER_ID",
    "customIntervalPrice": {
      "installments": [
        {
          # This installment starts immediately (no startTime is set).
          "priceModel": {
            "usage": {
              "defaultDiscountPercent": {
                # This is the default discount percentage on the usage skus.
                "value": "20"
              },
              "skuDiscounts": [
                {
                  # Sku IDs are retrieved from the standard offer.
                  "sku": "projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services/YOUR_SERVICE_NAME/skus/SKU1_ID",
                  "discountPercent": {
                    "value": "50"
                  }
                },
                {
                  "sku": "projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services/YOUR_SERVICE_NAME/skus/SKU2_ID",
                  "discountPercent": {
                    "value": "30"
                  }
                }
              ]
            },
            "commitment": {
              # The customer receives usage discounts: they pay $200 for this
              # installment, receive $200 in credit, and get 20% discount on
              # usage skus except SKU1 and SKU2.
              "commitmentAmount": {
                "currencyCode": "USD",
                "units": "200"
              }
            }
          }
        },
        {
          "startTime": {
            "year": 2026,
            "month": 5,
            "day": 14,
            "timeZone": {
              "id": "America/Los_Angeles"
            }
          },
          "priceModel": {
            "usage": {
              "defaultDiscountPercent": {
                "value": "20"
              }
            },
            "commitment": {
              "commitmentAmount": {
                "currencyCode": "USD",
                "units": "10000"
              }
            }
          }
        }
      ]
    }
  },
  "term": {
    "startPolicy": "IMMEDIATE",
    "endPolicy": "AFTER_DURATION",
    "durationMonths": 2,
    "maxRenewalCount": 0
  }
}' \
"https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers"

Início imediato, somente pagamento por uso (PAYG)

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
  "singleProductOffer": {
    "baseStandardOffer": "projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services/YOUR_SERVICE_NAME/standardOffers/STANDARD_OFFER_ID",
    "standardIntervalPrice": {
      "priceModel": {
        "usage": {
          "defaultDiscountPercent": {
            # This is the default discount percentage on the usage skus.
            "value": "34"
          }
        }
      }
    }
  },
  "term": {
    "startPolicy": "IMMEDIATE",
    "endPolicy": "AFTER_DURATION",
    "durationMonths": 3,
    "maxRenewalCount": 0
  }
}' \
"https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers"

Início programado, intervalo mensal, taxa fixa e uso

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
     -H "Content-Type: application/json" \
     -d '{
  "singleProductOffer": {
    "baseStandardOffer": "projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/services/YOUR_SERVICE_NAME/standardOffers/STANDARD_OFFER_ID",
    "standardIntervalPrice": {
      "standardInterval": "MONTHLY_NOT_PRORATED",
      "priceModel": {
        "usage": {
          "defaultDiscountPercent": {
            # This is the default discount percentage on the usage skus.
            "value": "20"
          }
        },
        "flatFee": {
          "flatFeeOverride": {
            "currencyCode": "USD",
            "units": "400"
          }
        }
      }
    },
    "features": [
      {
        "displayName": "Feature display name",
        "value": "Feature value"
      }
    ]
  },
  "term": {
    "startPolicy": "SCHEDULED_START_TIME",
    "scheduledStartTime": {
      "year": 2026,
      "month": 5,
      "day": 6,
      "timeZone": {
        "id": "America/Los_Angeles"
      }
    },
    "endPolicy": "AFTER_DURATION",
    "durationMonths": 12,
    "maxRenewalCount": 1
  }
}' \
"https://commerceproducer.googleapis.com/v1beta/projects/YOUR_PROJECT_ID_OR_NUMBER/locations/global/privateOffers"