Method: accounts.locations.media.list

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.