REST Resource: customers.inboundCustomerLinks

AI-generated Key Takeaways

• A CustomerLink represents a link between two Ads Data Hub customers.

• The JSON representation of a CustomerLink includes fields such as name, customerId, displayName, accessTypes, status, updateTime, and directParentCustomerIds.

• AccessType defines the types of access allowed through the link, including ADS_DATA, MATCH_DATA, MANAGEMENT, and AUDIENCE_LIST.

• The list method allows listing inbound customer links where another customer has granted access.

• Resource: CustomerLink
  • JSON representation
  • AccessType
• Methods

Resource: CustomerLink

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.

AccessType

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.