Method: customers.customerManagerLinks.moveManagerLink

• HTTP request
• Path parameters
• Request body
  • JSON representation
• Response body
  • JSON representation
• Authorization scopes
• Try it!

Moves a client customer to a new manager customer. This simplifies the complex request that requires two operations to move a client customer to a new manager, for example: 1. Update operation with Status INACTIVE (previous manager) and, 2. Update operation with Status ACTIVE (new manager).

List of thrown errors: AuthenticationError AuthorizationError DatabaseError FieldError HeaderError InternalError MutateError QuotaError RequestError

HTTP request

POST https://googleads.googleapis.com/v18/customers/{customerId}/customerManagerLinks:moveManagerLink

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customerId	string Required. The ID of the client customer that is being moved.

Request body

The request body contains data with the following structure:

JSON representation
{ "previousCustomerManagerLink": string, "newManager": string, "validateOnly": boolean }

Fields
previousCustomerManagerLink	string Required. The resource name of the previous CustomerManagerLink. The resource name has the form: customers/{customerId}/customerManagerLinks/{manager_customer_id}~{managerLinkId}
newManager	string Required. The resource name of the new manager customer that the client wants to move to. Customer resource names have the format: "customers/{customerId}"
validateOnly	boolean If true, the request is validated but not executed. Only errors are returned, not results.

Response body

Response message for a CustomerManagerLink moveManagerLink.

If successful, the response body contains data with the following structure:

JSON representation
{ "resourceName": string }

Fields
resourceName	string Returned for successful operations. Represents a CustomerManagerLink resource of the newly created link between client customer and new manager customer.

Authorization scopes

Requires the following OAuth scope:

• https://www.googleapis.com/auth/adwords

For more information, see the OAuth 2.0 Overview.