Method: accounts.locations.patch

  • This document outlines how to update a specific Google My Business location using the PATCH HTTP request method.

  • The request requires specifying the location's name in the URL path and can include optional query parameters like updateMask, validateOnly, and attributeMask to control the update process.

  • The request body should contain a Location object with the desired updates, and a successful response will return the updated Location object.

  • Authorization is necessary and requires one of the specified OAuth scopes: https://www.googleapis.com/auth/plus.business.manage or https://www.googleapis.com/auth/business.manage.

  • Photos can only be added to locations with an associated Google+ page, and attempting to update a non-existent location results in a NOT_FOUND error.

Updates the specified location.

Photos are only allowed on a location that has a Google+ page.

Returns NOT_FOUND if the location does not exist.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
name

string

The name of the location to update.

Query parameters

Parameters
updateMask

string (FieldMask format)

The specific fields to update. If no mask is specified, then this is treated as a full update and all fields are set to the values passed in, which may include unsetting empty fields in the request.

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

validateOnly

boolean

If true, the request is validated without actually updating the location.

attributeMask

string (FieldMask format)

The IDs of the attributes to update. Only attributes noted in the mask will be updated. If an attribute is present in the mask and not in the location, it will be removed. An empty mask will update all attributes.

Whenever this field is set, the updateMask should include attributes as one of the fields to update.

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 Location.

Response body

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

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.