Set up to receive reports

To receive your Cloud Marketplace reports, set up a Google Drive folder, a Cloud Storage bucket, or both. You must be an owner for the destination you choose. For example, if you use a Drive folder, your Google Cloud account must have the Can organize, add & edit permission for the folder.

Your reports can be stored in a shared Google Drive location, a Cloud Storage bucket, or both. When you set up your destination, your Google Workspace or Cloud Storage administrator must ensure that the destinations can be shared with the google.com and system.gserviceaccount.com domains.

• Learn about sharing permissions for Google Drive.
• Learn about restricting access to Google Cloud resources by domain.

When you add your report destination, the following accounts are added as editors or storage object administrators, as applicable:

• The [e-mail] service account, which uploads reports to the bucket.
• The [e-mail] Google group, to debug and troubleshoot issues that you might have with reports.

If you're setting up a Cloud Storage bucket, we recommend that you use access control lists (ACLs) for the bucket. We also recommend that you remove any retention policies that you might have on the bucket, because the retention policy might prevent reports from being updated until the retention period has passed.

If you use Uniform Bucket Level Access, note that the following organization policies might interfere with access:

• Domain Restricted Sharing prevents adding either of these principals into IAM for the bucket's project,
• Cross Project Service Account prevents adding the service account.

To remove these organization policies for your bucket, for the folder or project that holds your bucket, request that your organization policy administrator set the policy to the Google default handling.

After you set up a location to store the reports, you must set up how they are delivered.

To set up delivery, use the following steps:

1. In Producer Portal, open the Reports page. The direct link to the page is:

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

   Your public project ID is the ID of the project that hosts the components of your product. You create this project when you sign up to become a partner.

2. To add a report destination, click Add destination.

3. Under Destination location, select whether you want to send reports to a Google Drive folder or a Cloud Storage bucket.

4. Click Browse and select a folder or bucket, as applicable.

5. Select the report(s) to save in that destination. You can send each report to as many destinations as you need.

6. If you want additional levels of detail in usage reports, under Usage report options, select one or more of these options:

   • Separate customer usage by location: Splits your usage and disbursement report by the customers' locations.
   • Separate customer usage by billing account: Splits your usage and disbursement report by the customers' Cloud Billing accounts.

   For information on what is included in the report, see Charges and usage reports.

7. If you want to set up more destinations, repeat these steps.

8. Optionally, add one or more Cloud Billing accounts to use for testing. To learn about product testing, visit Testing your published Google Cloud Marketplace products.

9. To save your changes, click Save. You must agree to give the Cloud Marketplace accounts access to your report destinations.

Set up notifications for your reports

To ensure that you receive timely updates from the Google Cloud Marketplace team, we recommend that you set up notifications for your Cloud Marketplace reports. This can help you get your reports as quickly as possible if any of the following occur:

• Delayed reports.
• Reports with incomplete or inaccurate data.
• Reports that had to be regenerated.

To set up notifications for your Cloud Marketplace reports, complete the following steps:

1. Turn on the Essential Contacts API.

2. In Essential Contacts, add the individuals or groups that you want to receive reporting notifications to the Cloud Billing category.

Note: When you set up your organization's essential contacts, you can assign individuals, groups, or a mixture of both individuals and groups as contacts. To ensure that your notifications only go to active employees, and to reduce the impact of personnel changes, we recommend that you assign groups as your organization's contacts, and then control who gets notifications by managing the membership of those groups.