Method: accounts.locations.media.customers.list

  • Retrieves a paginated list of customer-contributed media items associated with a specific Google My Business location.

  • Allows specification of the page size and the use of page tokens for navigating through multiple pages of results.

  • Provides the total number of media items for the location, which may be approximate.

  • Requires authorization with either the plus.business.manage or business.manage scope.

  • Response includes media item details, total count, and a token for fetching subsequent pages.

Returns a list of media items associated with a location that have been contributed by customers.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
parent

string

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

Query parameters

Parameters
pageSize

integer

How many media items to return per page. The default value is 100, the maximum supported page size is 200.
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.ListCustomerMediaItems.

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. This number is approximate, particularly when there are multiple pages of results.
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.

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.