Ad Accounts

Accept, decline, cancel or end a manager link

Changed on

Accepts, declines or cancels a Google Ads manager invitation, or ends an existing manager-client link.

Changes one manager-client link, identified by managerCustomerId, clientCustomerId and managerLinkId (all from GET /v1/ads/accounts/hierarchy).

Actions

  • accept and decline: answer a pending invitation as the client (CustomerManagerLinkService). The connection's Google user needs direct access to the client account; access through a manager is not enough, because the link does not exist yet.
  • cancel: withdraws a pending invitation, as the manager (CustomerClientLinkService).
  • unlink: ends an active link, as the manager (CustomerClientLinkService).

Send validateOnly: true to have Google check the change without applying it.

patch/v1/ads/accounts/manager-links

Request

Request body

accountIdstring required

Google ads SocialAccount id.

managerCustomerIdstring required

Manager customer id, digits only.

clientCustomerIdstring required

Client customer id, digits only.

managerLinkIdstring required

Numeric link id from GET /v1/ads/accounts/hierarchy.

action'accept' | 'decline' | 'cancel' | 'unlink' required
validateOnlyboolean

Response

Link updated, or validated only when validateOnly is true

managerCustomerIdstring
clientCustomerIdstring
managerLinkIdstring nullable

Null on a validateOnly invitation, where Google creates nothing.

status'PENDING' | 'ACTIVE' | 'REFUSED' | 'CANCELED' | 'INACTIVE'

Status the link has after this call.

validateOnlyboolean

Changes

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status

    • info

      added the non-success response with the status