Google Business Performance API has a
NEW API method that allows fetching multiple `DailyMetrics` in a single API request. Review the
deprecation schedule and instructions to migrate over from v4 reportInsights API method to Google Business Profile Performance API.
Method: accounts.locations.media.customers.list
Stay organized with collections
Save and categorize content based on your preferences.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-16 UTC.
[null,null,["Last updated 2024-10-16 UTC."],[[["\u003cp\u003eRetrieves a paginated list of customer-contributed media items associated with a specific Google My Business location.\u003c/p\u003e\n"],["\u003cp\u003eAllows specification of the page size and the use of page tokens for navigating through multiple pages of results.\u003c/p\u003e\n"],["\u003cp\u003eProvides the total number of media items for the location, which may be approximate.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with either the \u003ccode\u003eplus.business.manage\u003c/code\u003e or \u003ccode\u003ebusiness.manage\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eResponse includes media item details, total count, and a token for fetching subsequent pages.\u003c/p\u003e\n"]]],[],null,["# Method: accounts.locations.media.customers.list\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ListCustomerMediaItemsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nReturns a list of media items associated with a location that have been contributed by customers.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/media/customers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------|\n| `parent` | `string` The name of the location whose customer media items will be listed. |\n\n### Query parameters\n\n| Parameters ||\n|-------------|----------------------------------------------------------------------------------------------------------------------|\n| `pageSize` | `integer` How many media items to return per page. The default value is 100, the maximum supported page size is 200. |\n| `pageToken` | `string` If specified, returns the next page of media items. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nIf successful, the response body contains data with the following structure:\nResponse message for Media.ListCustomerMediaItems.\n\n| JSON representation ||\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|---|\n| ``` { \"mediaItems\": [ { object (/my-business/reference/rest/v4/accounts.locations.media#MediaItem) } ], \"totalMediaItemCount\": integer, \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `mediaItems[]` | `object (`[MediaItem](/my-business/reference/rest/v4/accounts.locations.media#MediaItem)`)` The returned list of media items. |\n| `totalMediaItemCount` | `integer` The total number of media items for this location, irrespective of pagination. This number is approximate, particularly when there are multiple pages of results. |\n| `nextPageToken` | `string` If there are more media items than the requested page size, then this field is populated with a token to fetch the next page of media items on a subsequent call to customers.list. |\n\n### Authorization Scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/plus.business.manage`\n- `https://www.googleapis.com/auth/business.manage`\n\nFor more information, see the [OAuth 2.0 Overview](https://developers.google.com/identity/protocols/OAuth2)."]]