REST Resource: customers.inboundCustomerLinks

AI-generated Key Takeaways

CustomerLink represents a connection between two Ads Data Hub customers, enabling data sharing and management.
Links can grant access to Ads Data, Match Data, Management, and Audience List functionalities.
Inbound links represent access granted to the current customer, while outbound links represent access granted by the current customer.
Links are categorized by AccessType, defining the specific permissions granted, and LinkStatus, indicating the current state of the link.
You can list all inbound customer links using the list method.

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.