Method: customers.dataLinks.create

Creates a data link. The requesting Google Ads account name and account ID will be shared with the third party (such as YouTube creators for video links) to whom you are creating the link with. Only customers on the allow-list can create data links.

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

HTTP request

POST https://googleads.googleapis.com/v18/customers/{customerId}/dataLinks:create

The URL uses gRPC Transcoding syntax.

Path parameters

Parameters
customerId

string

Required. The ID of the customer for which the data link is created.

Request body

The request body contains data with the following structure:

JSON representation 
{
  "dataLink": {
    object (DataLink)
  }
}
Fields

Response body

Response message for DataLinkService.CreateDataLink.

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

JSON representation 
{
  "resourceName": string
}
Fields
resourceName

string

Returned for successful operations. Resource name of the data link.

Authorization scopes

Requires the following OAuth scope:

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

For more information, see the OAuth 2.0 Overview.