GOgoogle
accounts

PATCH /v1/accounts/{accountsId}

Updates the specified business account. Personal accounts cannot be updated using this method.

Request

Path parameters

accountsIdstring required

Query parameters

updateMaskstring google-fieldmask

Required. The specific fields that should be updated. The only editable field is accountName.

validateOnlyboolean

Optional. If true, the request is validated without actually updating the account.

Request body

accountNamestring

Required. The name of the account. For an account of type PERSONAL, this is the first and last name of the user account.

accountNumberstring

Output only. Account reference number if provisioned.

namestring

Immutable. The resource name, in the format accounts/{account_id}.

permissionLevel'PERMISSION_LEVEL_UNSPECIFIED' | 'OWNER_LEVEL' | 'MEMBER_LEVEL'

Output only. Specifies the permission level the user has for this account.

primaryOwnerstring

Required. Input only. The resource name of the account which will be the primary owner of the account being created. It should be of the form accounts/{account_id}.

role'ACCOUNT_ROLE_UNSPECIFIED' | 'PRIMARY_OWNER' | 'OWNER' | 'MANAGER' | 'SITE_MANAGER'

Output only. Specifies the AccountRole of this account.

type'ACCOUNT_TYPE_UNSPECIFIED' | 'PERSONAL' | 'LOCATION_GROUP' | 'USER_GROUP' | 'ORGANIZATION'

Required. Contains the type of account. Accounts of type PERSONAL and ORGANIZATION cannot be created using this API.

verificationState'VERIFICATION_STATE_UNSPECIFIED' | 'VERIFIED' | 'UNVERIFIED' | 'VERIFICATION_REQUESTED'

Output only. If verified, future locations that are created are automatically connected to Google Maps, and have Google+ pages created, without requiring moderation.

vettedState'VETTED_STATE_UNSPECIFIED' | 'NOT_VETTED' | 'VETTED' | 'INVALID'

Output only. Indicates whether the account is vetted by Google. A vetted account is able to verify locations via the VETTED_PARTNER method.

Response

Successful response

accountNamestring

Required. The name of the account. For an account of type PERSONAL, this is the first and last name of the user account.

accountNumberstring

Output only. Account reference number if provisioned.

namestring

Immutable. The resource name, in the format accounts/{account_id}.

permissionLevel'PERMISSION_LEVEL_UNSPECIFIED' | 'OWNER_LEVEL' | 'MEMBER_LEVEL'

Output only. Specifies the permission level the user has for this account.

primaryOwnerstring

Required. Input only. The resource name of the account which will be the primary owner of the account being created. It should be of the form accounts/{account_id}.

role'ACCOUNT_ROLE_UNSPECIFIED' | 'PRIMARY_OWNER' | 'OWNER' | 'MANAGER' | 'SITE_MANAGER'

Output only. Specifies the AccountRole of this account.

type'ACCOUNT_TYPE_UNSPECIFIED' | 'PERSONAL' | 'LOCATION_GROUP' | 'USER_GROUP' | 'ORGANIZATION'

Required. Contains the type of account. Accounts of type PERSONAL and ORGANIZATION cannot be created using this API.

verificationState'VERIFICATION_STATE_UNSPECIFIED' | 'VERIFIED' | 'UNVERIFIED' | 'VERIFICATION_REQUESTED'

Output only. If verified, future locations that are created are automatically connected to Google Maps, and have Google+ pages created, without requiring moderation.

vettedState'VETTED_STATE_UNSPECIFIED' | 'NOT_VETTED' | 'VETTED' | 'INVALID'

Output only. Indicates whether the account is vetted by Google. A vetted account is able to verify locations via the VETTED_PARTNER method.

Changes

No recorded changes to this operation across all 3 revisions of this API.