Ads Data Hub API

API zum Ausführen von Ads Data Hub-Abfragen

Dienst: adsdatahub.googleapis.com

Wir empfehlen, die von Google bereitgestellten Clientbibliotheken zu verwenden, um diesen Dienst aufzurufen. Wenn Ihre Anwendung zum Aufrufen dieses Dienstes Ihre eigenen Bibliotheken verwenden muss, verwenden Sie die folgenden Informationen, wenn Sie die API-Anfragen stellen.

Discovery-Dokument

Ein Discovery-Dokument ist eine maschinenlesbare Spezifikation zum Beschreiben und Nutzen von REST APIs. Sie wird verwendet, um Clientbibliotheken, IDE-Plug-ins und andere Tools zu erstellen, die mit Google APIs interagieren. Ein Dienst kann mehrere Discovery-Dokumente haben. Der Dienst stellt folgendes Discovery-Dokument zur Verfügung:

Dienstendpunkt

Ein Dienstendpunkt ist eine Basis-URL, die die Netzwerkadresse eines API-Dienstes angibt. Ein Dienst kann mehrere Dienstendpunkte haben. Dieser Dienst hat den folgenden Dienstendpunkt und alle nachstehenden URIs beziehen sich auf ihn:

  • https://adsdatahub.googleapis.com

REST-Ressource: v1.customers

Methoden
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
Beschreibt die gültigen DV360-Werbetreibenden-IDs
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
Führt gültige Ereignis-Matcher mit ihren Metadaten für Frequency Capping-Zielgruppenlisten auf.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
Exportiert den Jobverlauf eines Kundenkontos in das vom Kunden ausgewählte BigQuery-Dataset.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
Startet die Ausführung einer Abfrage, um Sichtbarkeitsmesswerte für ungültige Zugriffe für die DV360-Plattform abzurufen.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
Startet die Ausführung einer Abfrage, um eine tägliche Übersicht über die ungültigen Zugriffe für eine bestimmte Plattform abzurufen.
get GET /v1/{name=customers/*}
Ruft den angeforderten Ads Data Hub-Kunden ab.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
Gibt den Prozentsatz der Google-Daten für alle Kunden zurück, die am angegebenen Datum erfolgreich in ADH aufgenommen wurden.
list GET /v1/customers
Listet Ads Data Hub-Kunden auf, auf die der aktuelle Nutzer Zugriff hat.

REST-Ressource: v1.customers.adsDataCustomers

Methoden
get GET /v1/{name=customers/*/adsDataCustomers/*}
Ruft den angeforderten Ads Data Hub-Kunden ab.
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
Ruft das Datenzugriffsbudget für die angeforderte Anzeigenquelle in den letzten 366 Tagen ab.
list GET /v1/{parent=customers/*}/adsDataCustomers
Listet Anzeigendaten auf, auf die Kunden zugreifen können.

REST-Ressource: v1.customers.analysisAbfragen

Methoden
create POST /v1/{parent=customers/*}/analysisQueries
Erstellt eine Analyseabfrage zur späteren Ausführung.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
Löscht eine Analyseabfrage.
get GET /v1/{name=customers/*/analysisQueries/*}
Ruft die angeforderte Analyseabfrage ab.
list GET /v1/{parent=customers/*}/analysisQueries
Listet die Analyseabfragen des angegebenen Kunden auf.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
Aktualisiert eine vorhandene Analyseabfrage.
start POST /v1/{name=customers/*/analysisQueries/*}:start
Startet die Ausführung für eine gespeicherte Analyseabfrage.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
Startet die Ausführung für eine vorübergehende Analyseabfrage.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
Führt statische Validierungsprüfungen für die bereitgestellte Analyseabfrage durch.

REST-Ressource: v1.customers.customBiddingAlgorithms

Methoden
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
Fügen Sie dem Algorithmus für die benutzerdefinierte Gebotseinstellung einen DV360-Werbetreibenden hinzu.
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
Erstellt einen in Ads Data Hub verwalteten Algorithmus für die benutzerdefinierte Gebotseinstellung.
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
Löschen Sie diesen Algorithmus für die benutzerdefinierte Gebotseinstellung.
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
Hiermit werden die Impressionen der letzten 30 Tage für die benutzerdefinierten Gebotsmodelle bewertet.
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
Ruft den angeforderten Ads Data Hub-Algorithmus für die benutzerdefinierte Gebotseinstellung ab.
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
Listet die Algorithmen für die benutzerdefinierte Gebotseinstellung auf, die vom angegebenen Ads Data Hub-Kunden verwaltet werden.
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
Aktualisiert den angeforderten Ads Data Hub-Algorithmus für die benutzerdefinierte Gebotseinstellung.
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
Entfernen Sie einen DV360-Werbetreibenden aus dem Algorithmus für die benutzerdefinierte Gebotseinstellung.

REST-Ressource: v1.customers.tables

Methoden
get GET /v1/{name=customers/*/tables/*}
Ruft die angeforderte Ads Data Hub-Tabelle ab.
list GET /v1/{parent=customers/*}/tables
Führt die Ads Data Hub-Tabellen auf, auf die der angegebene Kunde zugreifen kann.

REST-Ressource: v1.customers.tempTables

Methoden
get GET /v1/{name=customers/*/tempTables/*}
Ruft die angeforderte temporäre Tabelle von Ads Data Hub ab.
list GET /v1/{parent=customers/*}/tempTables
Erstellt eine Liste der temporären Ads Data Hub-Tabellen, die der Kunde erstellt hat.

REST-Ressource: v1.customers.userListQuery

Methoden
create POST /v1/{parent=customers/*}/userListQueries
Erstellt eine Nutzerliste-Abfrage zur späteren Ausführung.
delete DELETE /v1/{name=customers/*/userListQueries/*}
Löscht eine Nutzerliste-Abfrage.
get GET /v1/{name=customers/*/userListQueries/*}
Ruft die angeforderte Nutzerliste-Abfrage ab.
list GET /v1/{parent=customers/*}/userListQueries
Listet die Abfragen der Nutzerliste des angegebenen Kunden auf.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
Aktualisiert eine vorhandene Abfrage der Nutzerliste.
start POST /v1/{name=customers/*/userListQueries/*}:start
Startet die Ausführung in einer gespeicherten Nutzerliste-Abfrage.
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
Startet die Ausführung bei einer temporären Nutzerliste-Abfrage.
validate POST /v1/{parent=customers/*}/userListQueries:validate
Führt statische Validierungsprüfungen für die angegebene Nutzerliste-Abfrage durch.

REST-Ressource: v1.customers.userLists

Methoden
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
Fügt Event-Matcher einer häufigkeitsbasierten Nutzerliste hinzu.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
Fügen Sie den Empfängern einer von Ads Data Hub verwalteten Nutzerliste Entitäten hinzu.
create POST /v1/{parent=customers/*}/userLists
Erstellt eine von Ads Data Hub verwaltete Nutzerliste.
delete DELETE /v1/{name=customers/*/userLists/*}
Löschen Sie die angeforderte, in Ads Data Hub verwaltete Nutzerliste.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
Generieren Sie Mitgliedschaften für die UID.
get GET /v1/{name=customers/*/userLists/*}
Ruft die angeforderte, von Ads Data Hub verwaltete Nutzerliste ab.
list GET /v1/{parent=customers/*}/userLists
Führt die Nutzerlisten auf, die vom angegebenen Ads Data Hub-Kunden verwaltet werden.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
Aktualisiert die angeforderte, in Ads Data Hub verwaltete Nutzerliste.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
Entfernt Entitäten aus den Empfängern einer von Ads Data Hub verwalteten Nutzerliste.

REST-Ressource: v1.operations

Methoden
cancel POST /v1/{name=operations/**}:cancel
Startet den asynchronen Abbruch eines lang andauernden Vorgangs.
delete DELETE /v1/{name=operations/**}
Löscht einen Vorgang mit langer Ausführungszeit.
get GET /v1/{name=operations/**}
Ruft den letzten Status eines lang andauernden Vorgangs ab.
list GET /v1/{name}
Listet Vorgänge auf, die zum angegebenen Filter in der Anfrage passen.
wait POST /v1/{name=operations/**}:wait
Wartet, bis der angegebene lang andauernde Vorgang abgeschlossen ist oder das angegebene Zeitlimit erreicht ist, wobei der letzte Status zurückgegeben wird.

REST-Ressource: v1.outages

Methoden
list GET /v1/outages
Listet die Ausfälle in absteigender Reihenfolge des Zeitstempels für den Ausfallbeginn auf und das Lookback-Window beträgt 130 Tage.