This is legacy documentation, and may not be complete. To see the latest documentation, if you are a marketer, refer to the Marketers site. If you are a measurement partner, refer to the Measurement Partners site.
Name that uniquely identifies an customer link. Inbound links have the form customers/[customerId]/inboundCustomerLinks/[linkedCustomerId]. Outbound links have the form customers/[customerId]/outboundCustomerLinks/[linkedCustomerId].
A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".
This field will only be set for inbound links. As the linked customer may or may not be directly linked, this field indicates the customer the linked customer is directly linked to. I.e. The current customer gets access to the linked customer through the indirect relationship connected by the direct parent(s). E.g., if A manages B and B manages C, then C will be listed as A's inbound link with its direct_parent_customer_id set to B. In the case of direct links, it will include the customer ID of the current customer.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2024-09-18 UTC."],[[["\u003cp\u003eCustomerLink represents a connection between two Ads Data Hub customers, enabling data sharing and access.\u003c/p\u003e\n"],["\u003cp\u003eIt includes details like customer IDs, display name, access types, status, and update time.\u003c/p\u003e\n"],["\u003cp\u003eInbound links provide access granted by other customers, while outbound links show access granted to others.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003edirectParentCustomerIds\u003c/code\u003e field is specific to inbound links and clarifies indirect relationships.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the \u003ccode\u003elist\u003c/code\u003e method to retrieve outbound customer links for a given customer.\u003c/p\u003e\n"]]],["CustomerLink represents a connection between two Ads Data Hub customers, identified by a unique name. The JSON representation includes the `name`, `customerId`, `displayName`, `accessTypes`, `status`, `updateTime`, and `directParentCustomerIds`. The `directParentCustomerIds` shows the direct links of an inbound link. Methods include `list` to view granted access links. The status, last update, and type of access are also shown.\n"],null,["# REST Resource: customers.outboundCustomerLinks\n\n- [Resource: CustomerLink](#CustomerLink)\n - [JSON representation](#CustomerLink.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CustomerLink\n----------------------\n\nRepresents a link between two Ads Data Hub customers.\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"name\": string, \"customerId\": string, \"displayName\": string, \"accessTypes\": [ enum (/ads-data-hub/reference/rest/v1/customers.inboundCustomerLinks#CustomerLink.AccessType) ], \"status\": enum (/ads-data-hub/reference/rest/v1/LinkStatus), \"updateTime\": string, \"directParentCustomerIds\": [ string ] } ``` |\n\n| Fields ||\n|-----------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` Name that uniquely identifies an customer link. Inbound links have the form customers/\\[customerId\\]/inboundCustomerLinks/\\[linkedCustomerId\\]. Outbound links have the form customers/\\[customerId\\]/outboundCustomerLinks/\\[linkedCustomerId\\]. |\n| `customerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Linked Ads Data Hub customer ID. |\n| `displayName` | `string` Linked customer's display name. |\n| `accessTypes[]` | `enum (`[AccessType](/ads-data-hub/reference/rest/v1/customers.inboundCustomerLinks#CustomerLink.AccessType)`)` Access types that are exposed through this link. |\n| `status` | `enum (`[LinkStatus](/ads-data-hub/reference/rest/v1/LinkStatus)`)` Status of the customer link. |\n| `updateTime` | `string (`[Timestamp](https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.Timestamp)` format)` Time the link status was last updated. A timestamp in RFC3339 UTC \"Zulu\" format, with nanosecond resolution and up to nine fractional digits. Examples: `\"2014-10-02T15:01:23Z\"` and `\"2014-10-02T15:01:23.045123456Z\"`. |\n| `directParentCustomerIds[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` This field will only be set for inbound links. As the linked customer may or may not be directly linked, this field indicates the customer the linked customer is directly linked to. I.e. The current customer gets access to the linked customer through the indirect relationship connected by the direct parent(s). E.g., if A manages B and B manages C, then C will be listed as A's inbound link with its direct_parent_customer_id set to B. In the case of direct links, it will include the customer ID of the current customer. |\n\n| Methods ------- ||\n|----------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------|\n| ### [list](/ads-data-hub/reference/rest/v1/customers.outboundCustomerLinks/list) | Lists links where the specified customer has granted access to other Ads Data Hub customers. |"]]