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:
- Software como serviço (SaaS)
(
SOFTWARE_AS_A_SERVICE) - Serviços profissionais
(
PROFESSIONAL_SERVICES) - Compartilhamento de produtos de dados no BigQuery (antigo Analytics Hub) (
ANALYTICS_HUB_LISTING)
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:
Ative a API Commerce Producer: ative o serviço
commerceproducer.googleapis.comno seu projeto:gcloud services enable commerceproducer.googleapis.comPara instruções sobre como ativar serviços, consulte Como ativar serviços.
Configurar bibliotecas de cliente: faça o download dos SDKs e das bibliotecas de cliente necessários. Para mais detalhes, consulte Bibliotecas de cliente.
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:
- Listar serviços: liste os serviços no projeto para encontrar aquele em que criar a oferta privada.
- 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.
- Descubra qual oferta alterar: ligue para
resolveAmendmentTargetpara saber se a nova oferta precisa alterar uma oferta atual ou não. - Criar a oferta
(
create PrivateOffer): chame a API para criar um recursoPrivateOfferno estadoDRAFT, definindo os detalhes básicos, a contabilling_namedo cliente e modelos de preços personalizados. - Anexar um documento
(
create PrivateOfferDocument): crie um recursoPrivateOfferDocumente 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 campodocumentRequirementdo recursoService:- Para a maioria dos serviços, como SaaS e produtos de dados,
documentRequirementlistaSTANDARD_END_USER_LICENSE_AGREEMENT_V2(EULA padrão) eCUSTOM_END_USER_LICENSE_AGREEMENT(EULA personalizado) comoOPTIONALporquedocumentRequirementexpressa apenas regras por tipo. Você ainda precisa anexarSTANDARD_END_USER_LICENSE_AGREEMENT_V2ouCUSTOM_END_USER_LICENSE_AGREEMENT. - Para serviços profissionais, a
STATEMENT_OF_WORK(SOW) éREQUIRED, aCUSTOM_END_USER_LICENSE_AGREEMENTéOPTIONALe os EULAs padrão sãoNOT_ALLOWED. STANDARD_END_USER_LICENSE_AGREEMENT_V1é substituído porSTANDARD_END_USER_LICENSE_AGREEMENT_V2e é sempreNOT_ALLOWEDpara novas ofertas.
- Para a maioria dos serviços, como SaaS e produtos de dados,
- Publicar a oferta
(
publish): chame o métodopublishpara finalizar a oferta e disponibilizá-la para o cliente aceitar. Use a flagvalidate_onlypara 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 comoDRAFT,PUBLISHEDeACCEPTED.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 campodocumentRequirementdo recursoService. Observação:STANDARD_END_USER_LICENSE_AGREEMENT_V1foi substituído e não é permitido para novas ofertas. Esses documentos são imutáveis depois que a oferta sai do estadoDRAFT.Service: o nome do serviço, que é um recurso somente leitura que representa um produto. Quando esse valor é definido, ele ajuda você a encontrar quaisStandardOffersestã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_SERVICESouANALYTICS_HUB_LISTING) ouPRODUCT_TYPE_UNSPECIFIEDpara qualquer outro tipo de produto.documentRequirement: os níveis de requisitos por tipo (REQUIRED,OPTIONALouNOT_ALLOWED) para documentos anexados a ofertas particulares no serviço. Um tipo de documento que não está listado não é permitido. ComodocumentRequirementexpressa apenas regras por tipo, ele listaSTANDARD_END_USER_LICENSE_AGREEMENT_V2eCUSTOM_END_USER_LICENSE_AGREEMENTcomoOPTIONALpara 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 umServiceé 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.adminouroles/commercepricemanagement.privateOffersAdmin- Como alternativa, o papel básico
roles/editortambém concede acesso.
- Como alternativa, o papel básico
- Para ações somente leitura:
roles/commerceproducer.viewerouroles/commercepricemanagement.viewer- Como alternativa, o papel básico
roles/viewertambém concede acesso.
- Como alternativa, o papel básico
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_PRORATEDstandard_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_UNSPECIFIEDstandard_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_PRORATEDstandard_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:30standard_interval_price.price_model.usage.sku_discounts[0].sku:SKU1(selecionaSKU1para aplicar um desconto personalizado)standard_interval_price.price_model.usage.sku_discounts[0].discount_percent:40(especifica um desconto de 40% emSKU1para 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_PRORATEDstandard_interval_price.price_model.commitment.commitment_amount:100(USD)standard_interval_price.price_model.commitment.discount_percent:20standard_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:100custom_interval_price.installments[0].price_model.commitment.discount_percent:20custom_interval_price.installments[0].price_model.commitment.additional_credit:25custom_interval_price.installments[0].price_model.commitment.discard_previous_credit_balance:trueoufalse(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:200custom_interval_price.installments[1].price_model.commitment.discount_percent:10custom_interval_price.installments[1].price_model.commitment.additional_credit:25custom_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:200custom_interval_price.installments[2].price_model.commitment.discount_percent:10custom_interval_price.installments[2].price_model.commitment.additional_credit:0custom_interval_price.installments[2].price_model.commitment.discard_previous_credit_balance:false(não descarte o saldo anterior para permitir a transferência).
- Parcela 1: compromisso de US$ 100, desconto de 20% (o cliente paga US $80), crédito adicional de US$ 25 (totalizando US $125).
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:IMMEDIATEterm.end_policy:AFTER_DURATIONterm.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:IMMEDIATEterm.end_policy:SCHEDULED_END_TIMEterm.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_TIMEterm.scheduled_start_time:2027-01-01term.end_policy:AFTER_DURATIONterm.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_TIMEterm.scheduled_start_time:2027-01-01term.end_policy:SCHEDULED_END_TIMEterm.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_OFFERterm.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
amendedPrivateOffernemamendedStandardOfferna oferta que você criar. requiredPrivateOffer: defina o campoamendedPrivateOfferda nova oferta com esse valor. Formato:projects/PROJECT/locations/global/privateOffers/PRIVATE_OFFER_IDrequiredStandardOffer: defina o campoamendedStandardOfferda nova oferta com esse valor. Formato:projects/PROJECT/locations/global/services/SERVICE/standardOffers/OFFER_IDoptionalOffers: uma lista de ofertas qualificadas que podem ser alteradas. Formato:projects/PROJECT/locations/global/privateOffers/PRIVATE_OFFER_IDVocê pode realizar uma das seguintes ações:
- Defina
amendedPrivateOffereamendedStandardOffercomo vazios. A nova oferta não altera outra oferta. - Defina
amendedPrivateOffercomo um dos recursos da listaoptionalOffers.
- Defina
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"