REST Resource: customers.inboundCustomerLinks

AI-generated Key Takeaways

CustomerLink represents a link between two Ads Data Hub customers, detailing various fields like name, customer ID, display name, access types, status, update time, and direct parent customer IDs.
The accessTypes field defines the different types of access allowed through the link, including ADS_DATA, MATCH_DATA, MANAGEMENT, and AUDIENCE_LIST.
The list method allows you to view inbound customer links where another Ads Data Hub customer has granted access to the specified customer.

Represents a link between two Ads Data Hub customers.

JSON representation
{ "name": string, "customerId": string, "displayName": string, "accessTypes": [ enum (`AccessType`) ], "status": enum (`LinkStatus`), "updateTime": string, "directParentCustomerIds": [ string ] }

Fields
`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].
`customerId`	`string (int64 format)` Linked Ads Data Hub customer ID.
`displayName`	`string` Linked customer's display name.
`accessTypes[]`	`enum (AccessType)` Access types that are exposed through this link.
`status`	`enum (LinkStatus)` Status of the customer link.
`updateTime`	`string (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"`.
`directParentCustomerIds[]`	`string (int64 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.

Types of access allowed.

Enums
`ACCESS_TYPE_UNSPECIFIED`	Unspecified access type.
`ADS_DATA`	If this is an inbound link, the linked customer has provided access to their Ads Data Hub ads data and can be listed as an adsDataCustomerId during query execution. If this is an outbound link, the linked customer has access to the current customer's ads data.
`MATCH_DATA`	If this is an inbound link, the linked customer has provided access to their Ads Data Hub match table data and can be listed as a matchDataCustomerId during query execution. If this is an outbound link, the linked customer has access to the current customer's match table data.
`MANAGEMENT`	Management links specify how link permissions propagate across customers. E.g., if A has an inbound management link to B and B has an inbound ads data link to C, then A has an indirect inbound ads data link to C. If A manages B and B manages C, then A will have inbound management links to both B and C, and C will have outbound management links to both A and B.
`AUDIENCE_LIST`	If this is an inbound link, the linked customer has provided access to create audience on behalf of them. If this is an outbound link, the linked customer can create audience on behalf of the current customer.

Methods
`list`	Lists links where another Ads Data Hub customer has granted access to the specified customer.