Search Ads 360 Reporting API . customers . customerClientLinks

close()

Close httplib2 connections.

mutate(customerId, body=None, x__xgafv=None)

Creates or updates a customer client link. Operation statuses are returned. List of thrown errors: [AuthenticationError]() [AuthorizationError]() [DatabaseError]() [FieldError]() [FieldMaskError]() [HeaderError]() [InternalError]() [ManagerLinkError]() [MutateError]() [NewResourceCreationError]() [QuotaError]() [RequestError]()

Args:
  customerId: string, Required. The ID of the customer whose customer link are being modified. (required)
  body: object, The request body.
    The object takes the form of:

{ # Request message for CustomerClientLinkService.MutateCustomerClientLink.
  "operation": { # A single operation (create, update) on a CustomerClientLink. # Required. The operation to perform on the individual CustomerClientLink.
    "create": { # Represents customer client link relationship. # Create operation: No resource name is expected for the new link.
      "clientCustomer": "A String", # Immutable. The client customer linked to this customer.
      "hidden": True or False, # The visibility of the link. Users can choose whether or not to see hidden links in the Google Ads UI. Default value is false
      "managerLinkId": "A String", # Output only. This is uniquely identifies a customer client link. Read only.
      "resourceName": "A String", # Immutable. Name of the resource. CustomerClientLink resource names have the form: `customers/{customer_id}/customerClientLinks/{client_customer_id}~{manager_link_id}`
      "status": "A String", # This is the status of the link between client and manager.
    },
    "update": { # Represents customer client link relationship. # Update operation: The link is expected to have a valid resource name.
      "clientCustomer": "A String", # Immutable. The client customer linked to this customer.
      "hidden": True or False, # The visibility of the link. Users can choose whether or not to see hidden links in the Google Ads UI. Default value is false
      "managerLinkId": "A String", # Output only. This is uniquely identifies a customer client link. Read only.
      "resourceName": "A String", # Immutable. Name of the resource. CustomerClientLink resource names have the form: `customers/{customer_id}/customerClientLinks/{client_customer_id}~{manager_link_id}`
      "status": "A String", # This is the status of the link between client and manager.
    },
    "updateMask": "A String", # FieldMask that determines which resource fields are modified in an update.
  },
  "validateOnly": True or False, # If true, the request is validated but not executed. Only errors are returned, not results.
}

  x__xgafv: string, V1 error format.
    Allowed values
      1 - v1 error format
      2 - v2 error format

Returns:
  An object of the form:

    { # Response message for a CustomerClientLink mutate.
  "result": { # The result for a single customer client link mutate. # A result that identifies the resource affected by the mutate request.
    "resourceName": "A String", # Returned for successful operations.
  },
}