REST Resource: customers.outboundCustomerLinks

AI-generated Key Takeaways

• CustomerLink represents a connection between two Ads Data Hub customers, enabling data sharing and access.

• It includes details like customer IDs, display name, access types, status, and update time.

• Inbound links provide access granted by other customers, while outbound links show access granted to others.

• The directParentCustomerIds field is specific to inbound links and clarifies indirect relationships.

• You can use the list method to retrieve outbound customer links for a given customer.

• Resource: CustomerLink
  • JSON representation
• 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.

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