GoogleAdsGoogleadsV25Services__MutateCustomerManagerLinkRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/google-ads/json-schema/google-ads-google-ads-googleads-v25-services-mutate-customer-manager-link-request-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__MutateCustomerManagerLinkRequest",
  "description": "Request message for CustomerManagerLinkService.MutateCustomerManagerLink.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-customers-customermanagerlinks-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__MutateCustomerManagerLinkRequest",
  "type": "object",
  "properties": {
    "validateOnly": {
      "description": "If true, the request is validated but not executed. Only errors are returned, not results.",
      "type": "boolean"
    },
    "operations": {
      "description": "Required. The list of operations to perform on individual customer manager links.",
      "items": {
        "$ref": "#/$defs/GoogleAdsGoogleadsV25Services__CustomerManagerLinkOperation"
      },
      "type": "array"
    }
  },
  "$defs": {
    "GoogleAdsGoogleadsV25Resources__CustomerManagerLink": {
      "type": "object",
      "properties": {
        "status": {
          "description": "Status of the link between the customer and the manager.",
          "type": "string",
          "x-enumDescriptions": [
            "Not specified.",
            "Used for return value only. Represents value unknown in this version.",
            "Indicates current in-effect relationship",
            "Indicates terminated relationship",
            "Indicates relationship has been requested by manager, but the client hasn't accepted yet.",
            "Relationship was requested by the manager, but the client has refused.",
            "Indicates relationship has been requested by manager, but manager canceled it."
          ],
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "ACTIVE",
            "INACTIVE",
            "PENDING",
            "REFUSED",
            "CANCELED"
          ]
        },
        "resourceName": {
          "type": "string",
          "description": "Immutable. Name of the resource. CustomerManagerLink resource names have the form: `customers/{customer_id}/customerManagerLinks/{manager_customer_id}~{manager_link_id}`"
        },
        "managerCustomer": {
          "description": "Output only. The manager customer linked to the customer.",
          "type": "string"
        },
        "managerLinkId": {
          "description": "Output only. ID of the customer-manager link. This field is read only.",
          "type": "string",
          "format": "int64"
        }
      },
      "description": "Represents customer-manager link relationship."
    },
    "GoogleAdsGoogleadsV25Services__CustomerManagerLinkOperation": {
      "description": "Updates the status of a CustomerManagerLink. The following actions are possible: 1. Update operation with status ACTIVE accepts a pending invitation. 2. Update operation with status REFUSED declines a pending invitation. 3. Update operation with status INACTIVE terminates link to manager.",
      "type": "object",
      "properties": {
        "update": {
          "description": "Update operation: The link is expected to have a valid resource name.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__CustomerManagerLink"
        },
        "updateMask": {
          "description": "FieldMask that determines which resource fields are modified in an update.",
          "type": "string",
          "format": "google-fieldmask"
        }
      }
    }
  }
}