Configurar para receber relatórios

É possível receber relatórios do Cloud Marketplace como uma tabela consultável do BigQuery, um arquivo CSV ou uma planilha do Google. Para configurar a tabela do BigQuery, consulte Relatórios no BigQuery.

Para receber seus relatórios do Cloud Marketplace no formato CSV, configure uma pasta do Google Drive, um bucket do Cloud Storage ou ambos. Você precisa ajustar o acesso ao destino escolhido. Por exemplo, se você usa uma pasta do Drive, sua Google Cloud conta precisa ser proprietária ou editora da pasta. Se você for um editor da pasta, o proprietário não poderá restringir a pasta para que apenas ele possa ajustar o acesso. Se a pasta estiver restrita, o proprietário precisará defini-la como um destino ou remover a restrição. Se a organização restringir quem pode ser adicionado a locais do Google Drive ou buckets do Cloud Storage, o administrador do Google Workspace ou do Cloud Storage precisará garantir que os destinos possam ser compartilhados com os domínios google.com e system.gserviceaccount.com.

Observação: não oferecemos suporte a locais compartilhados do Google Drive. Se você precisar armazenar seus relatórios em um local do Google Drive, use uma pasta localizada no nível superior do Google Drive.

• Saiba mais sobre as permissões de compartilhamento do Google Drive.
• Saiba como restringir o acesso a Google Cloud recursos por domínio.

Quando você adiciona o destino do seu relatório, as seguintes contas são adicionadas como editores ou administradores de objetos de armazenamento, conforme o caso:

• A conta de serviço [e-mail], que carrega relatórios no bucket.
• O grupo do Google [e-mail], para depurar e solucionar problemas que você possa ter com os relatórios.

Se você estiver configurando um bucket do Cloud Storage, recomendamos que você use listas de controle de acesso (ACLs) para o bucket. Também recomendamos que você remova todas as políticas de armazenamento que possam existir no bucket, já que a política de retenção pode impedir que os relatórios sejam atualizados até o fim do período de armazenamento.

Se você usar o recurso "Acesso uniforme no nível do bucket", as seguintes políticas da organização podem interferir no acesso:

• O Compartilhamento restrito de domínio impede a adição de um destes principais ao IAM para o projeto do bucket:
• A conta de serviço do projeto cruzado impede a adição da conta de serviço.

Para remover essas políticas da organização do bucket, da pasta ou do projeto que contém o bucket, solicite que o administrador da política da organização defina a política como o padrão do Google. Você também pode contornar uma ou ambas as políticas criando um grupo interno, adicionando os principais a esse grupo e concedendo as permissões necessárias.

Observação: se o administrador do domínio restringiu a associação ao grupo para excluir membros externos, ele poderá remover essa restrição para esse novo grupo usando as instruções a seguir.

Depois de configurar um local para armazenar os relatórios, você precisa configurar como eles serão entregues.

Para configurar a entrega, siga estas etapas:

1. No Portal do Produtor, abra a página Relatórios. O link direto para a página é:

   https://console.cloud.google.com/producer-portal/partner-report?project=YOUR_PUBLIC_PROJECT_ID
   

   Seu ID de projeto público é o ID do projeto que hospeda os componentes da sua solução. Você cria esse projeto quando se inscreve para se tornar um parceiro.

2. Para adicionar um destino de relatório, clique em Adicionar destino na guia "Exportação de CSV".

3. Em Local de destino, selecione se você quer enviar relatórios para uma pasta do Google Drive ou para um bucket do Cloud Storage.

4. Clique em Procurar e selecione uma pasta ou bucket, conforme o caso.

5. Selecione os relatórios para salvar nesse destino. É possível enviar cada relatório para quantos destinos forem necessários.

6. Se você quiser mais níveis de detalhes nos relatórios de uso, em Opções de relatório de uso, selecione uma ou mais destas opções:

   • Separar o uso do cliente por local: divide seu relatório de uso e gastos pelos locais dos clientes.
   • Uso separado do cliente por conta de faturamento: divide seu uso e relatório de reembolso pelas contas do Cloud Billing dos clientes.

   Para informações sobre o que está incluído no relatório, consulte Relatórios de cobranças e uso.

7. Para configurar mais destinos, repita essas etapas.

8. Se quiser, adicione uma ou mais contas de faturamento do Cloud para usar nos testes. Para saber mais sobre o teste de produtos, acesse Como testar seus produtos publicados do Google Cloud Marketplace.

9. Para salvar as alterações, clique em Salvar. Você precisa concordar em conceder às contas do Cloud Marketplace acesso aos destinos de seus relatórios.

Relatórios no BigQuery

Para receber seus relatórios do Cloud Marketplace no BigQuery, siga estas etapas:

1. Na página Relatórios do Portal do Produtor, navegue até a guia BigQuery Export.

2. Clique em Ativar exportação.

3. Se a API BigQuery ainda não estiver ativada no seu projeto, uma mensagem de aviso será exibida. Clique em Ativar e aguarde alguns minutos para que a mudança entre em vigor. Em seguida, clique em Ativar exportação novamente.

4. Depois de ativar a exportação, aguarde até 24 horas para que os dados sejam preenchidos. Um conjunto de dados vinculado é criado no seu projeto, que pode ser usado para acessar e analisar seus dados.

Quando você ativa o BigQuery Export, os seguintes relatórios ficam disponíveis:

• Insights diários incrementais: relatórios diários sobre o uso.
• Insights mensais incrementais: relatórios mensais sobre o uso, gerados uma vez por mês.
• Relatório de reembolso detalhado: dados de reconciliação financeira, gerados uma vez por mês.

Custos incorridos pelos parceiros

Os parceiros do Google Cloud Marketplace não incorrerão em custos de armazenamento do BigQuery como parte da ativação desse recurso para os projetos do Portal do Produtor. No entanto, os custos apropriados do BigQuery serão incorridos para consultas sobre os dados, como consultas SQL, funções definidas pelo usuário, scripts e determinadas instruções de linguagem de manipulação de dados (DML, na sigla em inglês) e de linguagem de definição de dados (DDL, na sigla em inglês). Saiba mais sobre os preços do BigQuery.

Política de retenção de dados do BigQuery

Depois de ativado, o sistema preenche os dados históricos de aproximadamente os últimos dois anos. O período de armazenamento de dados para esses relatórios é de cinco anos.

Solução de problemas

Se o conjunto de dados vinculado for excluído acidentalmente, você poderá recuperá-lo desativando e reativando a exportação na guia BigQuery Export.

Se você receber uma mensagem de erro como US violates constraint constraints/gcp.resourceLocations on the resource projects/YOUR_PROJECT_ID/datasets/marketplace_report, sua organização tem uma restrição de política da organização que impede a criação de conjuntos de dados do BigQuery na multirregião US. Como os relatórios do BigQuery são armazenados na multirregião US, é necessário atualizar a restrição de local para permitir que os conjuntos de dados do BigQuery sejam criados na multirregião US. Para mais informações, consulte Como restringir locais de recursos.

Configurar notificações para seus relatórios

Para receber atualizações oportunas da equipe do Google Cloud Marketplace, recomendamos que você configure notificações para seus relatórios do Cloud Marketplace. Isso pode ajudar você a receber seus relatórios o mais rápido possível se ocorrer alguma das seguintes situações:

• Relatórios atrasados.
• Relatórios com dados incompletos ou imprecisos.
• Relatórios que precisaram ser regenerados.

Para configurar notificações para seus relatórios do Cloud Marketplace, siga estas etapas:

1. Ative a API Essential Contacts.

2. Em Contatos essenciais, adicione as pessoas ou grupos que você quer que recebam notificações de relatórios à categoria Cloud Billing.

Observação: ao configurar os contatos essenciais da sua organização, você pode atribuir pessoas, grupos ou uma mistura de pessoas e grupos como contatos. Para garantir que as notificações sejam enviadas apenas para funcionários ativos e reduzir o impacto das mudanças de pessoal, recomendamos que você atribua grupos como contatos da sua organização e controle quem recebe notificações gerenciando a participação desses grupos.