GoogleAdsGoogleadsV25Services__CreateDataLinkRequest

{
  "$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-create-data-link-request-schema.json",
  "title": "GoogleAdsGoogleadsV25Services__CreateDataLinkRequest",
  "description": "Request message for DataLinkService.CreateDataLink.",
  "x-generated": "2026-11-04",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/google-ads-customers-datalinks-api-openapi.yml#/components/schemas/GoogleAdsGoogleadsV25Services__CreateDataLinkRequest",
  "type": "object",
  "properties": {
    "dataLink": {
      "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__DataLink",
      "description": "Required. The data link to be created."
    }
  },
  "$defs": {
    "GoogleAdsGoogleadsV25Resources__DataLink": {
      "description": "Represents the data sharing connection between a Google Ads customer and another product's data.",
      "type": "object",
      "properties": {
        "dataLinkId": {
          "format": "int64",
          "description": "Output only. The ID of the data link. This field is read only.",
          "type": "string"
        },
        "status": {
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "REQUESTED",
            "PENDING_APPROVAL",
            "ENABLED",
            "DISABLED",
            "REVOKED",
            "REJECTED"
          ],
          "description": "Output only. The status of the data link.",
          "type": "string",
          "x-enumDescriptions": [
            "Not specified.",
            "The value is unknown in this version.",
            "Link has been requested by one party, but not confirmed by the other party.",
            "Link is waiting for the customer to approve.",
            "Link is established and can be used as needed.",
            "Link is no longer valid and should be ignored.",
            "Link request has been cancelled by the requester and further cleanup may be needed.",
            "Link request has been rejected by the approver."
          ]
        },
        "type": {
          "description": "Output only. The type of the data.",
          "type": "string",
          "enum": [
            "UNSPECIFIED",
            "UNKNOWN",
            "VIDEO"
          ],
          "x-enumDescriptions": [
            "Not specified.",
            "The value is unknown in this version.",
            "A data link to YouTube video."
          ]
        },
        "productLinkId": {
          "type": "string",
          "description": "Output only. The ID of the link. This field is read only.",
          "format": "int64"
        },
        "youtubeLinkMetadata": {
          "description": "Immutable. Metadata for a YouTube link.",
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__YoutubeLinkMetadata"
        },
        "youtubeVideo": {
          "$ref": "#/$defs/GoogleAdsGoogleadsV25Resources__YoutubeVideoIdentifier",
          "description": "Immutable. A data link to YouTube video."
        },
        "resourceName": {
          "description": "Immutable. Resource name of the product data link. DataLink resource names have the form: `customers/{customer_id}/dataLinks/{product_link_id}~{data_link_id}`",
          "type": "string"
        }
      }
    },
    "GoogleAdsGoogleadsV25Resources__YoutubeLinkMetadata": {
      "type": "object",
      "properties": {
        "brandChannelId": {
          "description": "Immutable. The ID of a YouTube brand channel to help creators understand your brand. The channel must be linked to this account. This is a string value with “UC” prefix. For example, \"UCK8sQmJBp8GCxrOtXWBpyEA\".",
          "type": "string"
        }
      },
      "description": "Metadata specific to YouTube links."
    },
    "GoogleAdsGoogleadsV25Resources__YoutubeVideoIdentifier": {
      "description": "The identifier for YouTube video",
      "type": "object",
      "properties": {
        "videoId": {
          "description": "Immutable. The ID of the video associated with the video link. This is the 11 character string value used in the YouTube video URL. For example, video ID is jV1vkHv4zq8 from the YouTube video URL \"https://www.youtube.com/watch?v=jV1vkHv4zq8&t=2s\".",
          "type": "string"
        },
        "channelId": {
          "type": "string",
          "description": "Immutable. The ID of the hosting channel of the video. This is a string value with “UC” prefix. For example, \"UCK8sQmJBp8GCxrOtXWBpyEA\"."
        }
      }
    }
  }
}