REST Resource: customers.inboundCustomerLinks

• Ressource: CustomerLink
  • JSON-Darstellung
  • AccessType
• Methoden

Ressource: CustomerLink

Eine Verknüpfung zwischen zwei Ads Data Hub-Kunden

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

Felder
name	string Name, der einen Kundenlink eindeutig identifiziert. Eingehende Links haben das Format „customers/[customerId]/inboundCustomerLinks/[linkedCustomerId]“. Ausgehende Links haben das Format „kunden/[kunden-ID]/outboundCustomerLinks/[linkedCustomerId]“.
customerId	string (int64 format) Verknüpfte Ads Data Hub-Kundennummer.
displayName	string Angezeigter Name des verknüpften Kunden
accessTypes[]	enum (AccessType) Zugriffstypen, die über diesen Link verfügbar gemacht werden.
status	enum (LinkStatus) Status der Kundenverknüpfung.
updateTime	string (Timestamp format) Uhrzeit der letzten Aktualisierung des Verknüpfungsstatus. Ein Zeitstempel im Format RFC3339 UTC mit Nanosekundenauflösung und bis zu neun Nachkommastellen. Beispiele: "2014-10-02T15:01:23Z" und "2014-10-02T15:01:23.045123456Z".
directParentCustomerIds[]	string (int64 format) Dieses Feld wird nur für eingehende Links festgelegt. Da der verknüpfte Kunde möglicherweise direkt verknüpft ist, gibt dieses Feld an, mit welchem Kunden der verknüpfte Kunde direkt verknüpft ist. Das heißt, der aktuelle Kunde erhält Zugriff auf den verknüpften Kunden über die indirekte Beziehung, die durch die direkten Eltern verbunden ist. Wenn beispielsweise A von B verwaltet wird und B von C verwaltet wird, wird C als eingehender Link von A aufgeführt, wobei seine „direct_parent_customer_id“ auf B gesetzt ist. Bei direkten Links wird die Kundennummer des aktuellen Kunden angegeben.

Zugriffstyp

Zulässige Zugriffstypen.

Enums
ACCESS_TYPE_UNSPECIFIED	Nicht angegebener Zugriffstyp.
ADS_DATA	Wenn es sich um eine eingehende Verknüpfung handelt, hat der verknüpfte Kunde Zugriff auf seine Ads Data Hub-Anzeigendaten gewährt und kann bei der Ausführung der Abfrage als „AdsDataCustomerId“ aufgeführt werden. Wenn es sich um einen externen Link handelt, hat der verknüpfte Kunde Zugriff auf die Anzeigendaten des aktuellen Kunden.
MATCH_DATA	Wenn es sich um eine eingehende Verknüpfung handelt, hat der verknüpfte Kunde Zugriff auf seine Ads Data Hub-Match-Table-Daten gewährt und kann während der Abfrageausführung als „matchDataCustomerId“ aufgeführt werden. Wenn es sich um einen externen Link handelt, hat der verknüpfte Kunde Zugriff auf die Match-Table-Daten des aktuellen Kunden.
MANAGEMENT	Mit Verwaltungslinks legen Sie fest, wie Linkberechtigungen auf Kunden angewendet werden. Beispiel: A hat einen Link für die eingehende Verwaltung zu B und B hat einen Datenlink für eingehende Anzeigen zu C, dann hat A einen indirekten Link zu Daten für C. Wenn A für B und B C verwaltet, hat A sowohl eingehende Verwaltungslinks zu B und C als auch C hat ausgehende Verwaltungslinks zu A und B.
AUDIENCE_LIST	Wenn es sich um einen eingehenden Link handelt, hat der verknüpfte Kunde Zugriff gewährt, um eine Zielgruppe im Namen des Kunden zu erstellen. Wenn es sich um einen externen Link handelt, kann der verknüpfte Kunde im Namen des aktuellen Kunden eine Zielgruppe erstellen.

Methoden
list	Führt Links auf, bei denen einem anderen Ads Data Hub-Kunden Zugriff auf den angegebenen Kunden gewährt wurde.