Method: accounts.locations.media.list

  • Retrieves a list of media items associated with a specific Google My Business location.

  • Allows for pagination to handle large sets of media items, with a maximum page size of 2500.

  • Returns details such as media item data, total item count, and a token for accessing subsequent pages.

  • Requires specific OAuth scopes for authorization, including https://www.googleapis.com/auth/plus.business.manage or https://www.googleapis.com/auth/business.manage.

Returns a list of media items associated with a location.

HTTP request

GET https://mybusiness.googleapis.com/v4/{parent=accounts/*/locations/*}/media

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

The name of the location whose media items will be listed.

Query parameters

Parameters
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.
pageToken

string

If specified, returns the next page of media items.

Request body

The request body must be empty.

Response body

If successful, the response body contains data with the following structure:

Response message for Media.ListMediaItems.

JSON representation 
{
  "mediaItems": [
    {
      object (MediaItem)
    }
  ],
  "totalMediaItemCount": integer,
  "nextPageToken": string
}
Fields
mediaItems[]

object (MediaItem)

The returned list of media items.
totalMediaItemCount

integer

The total number of media items for this location, irrespective of pagination.
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.

Authorization Scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

For more information, see the OAuth 2.0 Overview.