Update your Google Business Profile API integration before critical endpoints are disabled. Review the deprecation schedule and instructions to avoid disruptions starting in April 2022.
The Business Profile Performance API is now launched! Migration work is required.

Method: accounts.locations.media.patch

Updates metadata of the specified media item. This can only be used to update the Category of a media item, with the exception that the new category cannot be COVER or PROFILE.

HTTP request

PATCH https://mybusiness.googleapis.com/v4/{name=accounts/*/locations/*/media/*}

The URL uses gRPC Transcoding syntax.

Path parameters



The name of the media item to be updated.

Query parameters


string (FieldMask format)

The specific fields to update. If no mask is specified, then this is treated as a full update and all editable fields are set to the values passed in.

This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".

Request body

The request body contains an instance of MediaItem.

Response body

If successful, the response body contains an instance of MediaItem.

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.