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.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 2025-08-28 UTC.
[null,null,["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eRetrieves a list of media items associated with a specific Google My Business location.\u003c/p\u003e\n"],["\u003cp\u003eAllows for pagination to handle large sets of media items, with a maximum page size of 2500.\u003c/p\u003e\n"],["\u003cp\u003eReturns details such as media item data, total item count, and a token for accessing subsequent pages.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific OAuth scopes for authorization, including \u003ccode\u003ehttps://www.googleapis.com/auth/plus.business.manage\u003c/code\u003e or \u003ccode\u003ehttps://www.googleapis.com/auth/business.manage\u003c/code\u003e.\u003c/p\u003e\n"]]],["This describes retrieving a list of media items associated with a location via a `GET` request to `https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/media`. The `parent` path parameter specifies the location. Optional query parameters include `pageSize` (default 100, max 2500) and `pageToken` for pagination. The response body contains an array of `mediaItems`, `totalMediaItemCount`, and `nextPageToken` for further pagination. The request body must be empty. Requires OAuth scopes: `plus.business.manage` or `business.manage`.\n"],null,["# Method: accounts.locations.media.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.ListMediaItemsResponse.SCHEMA_REPRESENTATION)\n- [Authorization Scopes](#body.aspect)\n\nReturns a list of media items associated with a location.\n\n### HTTP request\n\n`GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/media`\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 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, which is also the maximum supported number of media items able to be added to a location with the Google My Business API. Maximum page size is 2500. |\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.ListMediaItems.\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. |\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 media.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)."]]