Method: requestStatus.retrieve

Ruft den Status einer Anfrage anhand der Anfrage-ID ab.

HTTP-Anfrage

GET https://datamanager.googleapis.com/v1/requestStatus:retrieve

Die URL verwendet die Syntax der gRPC-Transcodierung.

Abfrageparameter

Parameter
requestId

string

Erforderlich. Erforderlich. Die Anfrage-ID der Data Manager API-Anfrage.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Antwort von RetrieveRequestStatusRequest.

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

JSON-Darstellung
{
  "requestStatusPerDestination": [
    {
      object (RequestStatusPerDestination)
    }
  ]
}
Felder
requestStatusPerDestination[]

object (RequestStatusPerDestination)

Eine Liste der Anfragestatus pro Ziel. Die Reihenfolge der Status entspricht der Reihenfolge der Ziele in der ursprünglichen Anfrage.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/datamanager

RequestStatusPerDestination

Ein Anfragestatus pro Ziel.

JSON-Darstellung
{
  "destination": {
    object (Destination)
  },
  "requestStatus": enum (RequestStatus),
  "errorInfo": {
    object (ErrorInfo)
  },
  "warningInfo": {
    object (WarningInfo)
  },

  // Union field status can be only one of the following:
  "audienceMembersIngestionStatus": {
    object (IngestAudienceMembersStatus)
  },
  "eventsIngestionStatus": {
    object (IngestEventsStatus)
  },
  "audienceMembersRemovalStatus": {
    object (RemoveAudienceMembersStatus)
  }
  // End of list of possible types for union field status.
}
Felder
destination

object (Destination)

Ein Ziel in einer DM API-Anfrage.

requestStatus

enum (RequestStatus)

Der Anfragestatus des Ziels.

errorInfo

object (ErrorInfo)

Ein Fehlerinformationsobjekt mit dem Fehlergrund und der Anzahl der Fehler im Zusammenhang mit dem Upload.

warningInfo

object (WarningInfo)

Eine Warnung mit dem Grund für die Warnung und der Anzahl der Warnungen im Zusammenhang mit dem Upload.

Union-Feld status. Der Status des Ziels. Für status ist nur einer der folgenden Werte zulässig:
audienceMembersIngestionStatus

object (IngestAudienceMembersStatus)

Der Status der Anfrage zum Erfassen von Zielgruppenmitgliedern.

eventsIngestionStatus

object (IngestEventsStatus)

Der Status der Anfrage zum Erfassen von Ereignissen.

audienceMembersRemovalStatus

object (RemoveAudienceMembersStatus)

Der Status des Antrags zum Entfernen von Zielgruppenmitgliedern.

RequestStatus

Der Status der Anfrage.

Enums
REQUEST_STATUS_UNKNOWN Der Anfragestatus ist unbekannt.
SUCCESS Die Anfrage war erfolgreich.
PROCESSING Die Anfrage wird bearbeitet.
FAILED Die Anfrage ist fehlgeschlagen.
PARTIAL_SUCCESS Die Anfrage war teilweise erfolgreich.

Fehlerinformation

Die Anzahl der Fehler für jeden Fehlertyp.

JSON-Darstellung
{
  "errorCounts": [
    {
      object (ErrorCount)
    }
  ]
}
Felder
errorCounts[]

object (ErrorCount)

Eine Liste von Fehlern und die Anzahl der einzelnen Fehlerursachen. Möglicherweise werden nicht in allen Fällen Daten angezeigt.

ErrorCount

Die Anzahl der Fehler für einen bestimmten Fehlergrund.

JSON-Darstellung
{
  "recordCount": string,
  "reason": enum (ProcessingErrorReason)
}
Felder
recordCount

string (int64 format)

Anzahl der Datensätze, die aus einem bestimmten Grund nicht hochgeladen werden konnten.

reason

enum (ProcessingErrorReason)

Der Fehlergrund für die fehlgeschlagenen Datensätze.

ProcessingErrorReason

Der Grund für den Verarbeitungsfehler.

Enums
PROCESSING_ERROR_REASON_UNSPECIFIED Der Grund für den Verarbeitungsfehler ist unbekannt.
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE Die benutzerdefinierte Variable ist ungültig.
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED Der Status der benutzerdefinierten Variable ist nicht „Aktiviert“.
PROCESSING_ERROR_REASON_EVENT_TOO_OLD Die Conversion ist älter als das erlaubte Höchstalter.
PROCESSING_ERROR_REASON_DUPLICATE_GCLID Es ist bereits eine Conversion mit derselben Kombination aus GCLID sowie Datum und Uhrzeit der Conversion im System vorhanden.
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID Es wurde bereits eine Conversion mit derselben Kombination aus Bestell-ID und Conversion-Aktion hochgeladen.
PROCESSING_ERROR_REASON_INVALID_GBRAID Die GBRAID konnte nicht decodiert werden.
PROCESSING_ERROR_REASON_INVALID_GCLID Die Google-Klick-ID konnte nicht decodiert werden.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID Die Händler-ID enthält Zeichen, die keine Ziffern sind.
PROCESSING_ERROR_REASON_INVALID_WBRAID Die WBRAID konnte nicht decodiert werden.
PROCESSING_ERROR_REASON_INTERNAL_ERROR Interner Fehler.
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED Die Nutzungsbedingungen für erweiterte Conversions wurden im Zielkonto nicht unterzeichnet.
PROCESSING_ERROR_REASON_INVALID_EVENT Das Ereignis ist ungültig.
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS Die Anzahl der abgeglichenen Transaktionen liegt unter dem Mindestschwellenwert.
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS Die Transaktionen liegen unter dem Mindestbetrag.
PROCESSING_ERROR_REASON_INVALID_FORMAT Der Termin weist einen Formatierungsfehler auf.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR Das Ereignis enthält einen Entschlüsselungsfehler.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR Das DEK konnte nicht entschlüsselt werden.
PROCESSING_ERROR_REASON_INVALID_WIP Der WIP ist falsch formatiert oder nicht vorhanden.
PROCESSING_ERROR_REASON_INVALID_KEK Mit dem KEK können keine Daten entschlüsselt werden, weil er falsch ist oder nicht vorhanden ist.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED Das WIP konnte nicht verwendet werden, da es aufgrund der Attestierungsbedingung abgelehnt wurde.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED Das System hatte nicht die erforderlichen Berechtigungen, um auf den KEK zuzugreifen.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Die UserIdentifier-Daten konnten mit dem DEK nicht entschlüsselt werden.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER Der Nutzer hat versucht, Ereignisse mit einer Werbe-ID zu erfassen, die nicht zu den Anzeigen des Betriebskontos gehört.

WarningInfo

Anzahl der Warnungen für jeden Warnungstyp.

JSON-Darstellung
{
  "warningCounts": [
    {
      object (WarningCount)
    }
  ]
}
Felder
warningCounts[]

object (WarningCount)

Eine Liste der Warnungen und Anzahl pro Warngrund.

WarningCount

Die Anzahl der Warnungen für einen bestimmten Warnungsgrund.

JSON-Darstellung
{
  "recordCount": string,
  "reason": enum (ProcessingWarningReason)
}
Felder
recordCount

string (int64 format)

Die Anzahl der Datensätze, für die eine Warnung ausgegeben wurde.

reason

enum (ProcessingWarningReason)

Der Grund für die Warnung.

ProcessingWarningReason

Der Grund für die Verarbeitungswarnung.

Enums
PROCESSING_WARNING_REASON_UNSPECIFIED Der Grund für die Verarbeitungswarnung ist unbekannt.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED Das System hatte nicht die erforderlichen Berechtigungen, um auf den KEK zuzugreifen.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR Das DEK konnte nicht entschlüsselt werden.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR Das Ereignis enthält einen Entschlüsselungsfehler.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED Das WIP konnte nicht verwendet werden, da es aufgrund der Attestierungsbedingung abgelehnt wurde.
PROCESSING_WARNING_REASON_INVALID_WIP Der WIP ist falsch formatiert oder nicht vorhanden.
PROCESSING_WARNING_REASON_INVALID_KEK Mit dem KEK können keine Daten entschlüsselt werden, weil er falsch ist oder nicht vorhanden ist.
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR Die UserIdentifier-Daten konnten mit dem DEK nicht entschlüsselt werden.
PROCESSING_WARNING_REASON_INTERNAL_ERROR Interner Fehler.

IngestAudienceMembersStatus

Der Status der Anfrage zum Erfassen von Zielgruppenmitgliedern.

JSON-Darstellung
{

  // Union field status can be only one of the following:
  "userDataIngestionStatus": {
    object (IngestUserDataStatus)
  },
  "mobileDataIngestionStatus": {
    object (IngestMobileDataStatus)
  },
  "pairDataIngestionStatus": {
    object (IngestPairDataStatus)
  }
  // End of list of possible types for union field status.
}
Felder
Union-Feld status. Der Status der Aufnahme der Zielgruppenmitglieder in das Ziel. Für status ist nur einer der folgenden Werte zulässig:
userDataIngestionStatus

object (IngestUserDataStatus)

Status der Aufnahme der Nutzerdaten in das Ziel.

mobileDataIngestionStatus

object (IngestMobileDataStatus)

Der Status der Aufnahme mobiler Daten am Zielort.

pairDataIngestionStatus

object (IngestPairDataStatus)

Der Status der Aufnahme von Paardaten in das Ziel.

IngestUserDataStatus

Der Status der Aufnahme von Nutzerdaten in das Ziel mit Statistiken zur Aufnahme.

JSON-Darstellung
{
  "recordCount": string,
  "userIdentifierCount": string,
  "uploadMatchRateRange": enum (MatchRateRange)
}
Felder
recordCount

string (int64 format)

Die Gesamtzahl der Zielgruppenmitglieder, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht.

userIdentifierCount

string (int64 format)

Die Gesamtzahl der Nutzer-IDs, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Nutzerkennungen in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht.

uploadMatchRateRange

enum (MatchRateRange)

Der Bereich der Abgleichsrate des Uploads.

MatchRateRange

Der Bereich der Abgleichsrate des Uploads oder der Nutzerliste.

Enums
MATCH_RATE_RANGE_UNKNOWN Der Bereich der Übereinstimmungsrate ist unbekannt.
MATCH_RATE_RANGE_NOT_ELIGIBLE Der Bereich der Übereinstimmungsrate ist nicht zulässig.
MATCH_RATE_RANGE_LESS_THAN_20 Der Bereich der Abgleichsrate liegt unter 20% (im Intervall [0, 20)).
MATCH_RATE_RANGE_20_TO_30 Die Abgleichsrate liegt zwischen 20% und 30% (im Intervall [20, 31)).
MATCH_RATE_RANGE_31_TO_40 Die Abgleichsrate liegt zwischen 31% und 40% (im Intervall [31, 41)).
MATCH_RATE_RANGE_41_TO_50 Die Abgleichsrate liegt zwischen 41% und 50% (im Intervall [41, 51)).
MATCH_RATE_RANGE_51_TO_60 Die Abgleichsrate liegt zwischen 51% und 60% (im Intervall [51, 61)).
MATCH_RATE_RANGE_61_TO_70 Die Abgleichsrate liegt zwischen 61% und 70% (im Intervall [61, 71)).
MATCH_RATE_RANGE_71_TO_80 Die Abgleichsrate liegt zwischen 71% und 80% (im Intervall [71, 81)).
MATCH_RATE_RANGE_81_TO_90 Die Abgleichsrate liegt zwischen 81% und 90% (im Intervall [81, 91)).
MATCH_RATE_RANGE_91_TO_100

Die Abgleichsrate liegt zwischen 91% und 100% (im Intervall [91, 100]).

IngestMobileDataStatus

Der Status der Erfassung mobiler Daten für das Ziel, einschließlich Statistiken zur Erfassung.

JSON-Darstellung
{
  "recordCount": string,
  "mobileIdCount": string
}
Felder
recordCount

string (int64 format)

Die Gesamtzahl der Zielgruppenmitglieder, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht.

mobileIdCount

string (int64 format)

Die Gesamtzahl der mobilen IDs, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Mobilgeräte-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich erfasst wurden oder nicht.

IngestPairDataStatus

Der Status der Aufnahme von Paardaten in das Ziel, das Statistiken zur Aufnahme enthält.

JSON-Darstellung
{
  "recordCount": string,
  "pairIdCount": string
}
Felder
recordCount

string (int64 format)

Die Gesamtzahl der Zielgruppenmitglieder, die in der Uploadanfrage für das Ziel gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht.

pairIdCount

string (int64 format)

Die Gesamtzahl der in der Uploadanfrage für das Ziel gesendeten Paar-IDs. Enthält alle Paar-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich aufgenommen wurden oder nicht.

IngestEventsStatus

Der Status der Ereignisaufnahme am Zielort.

JSON-Darstellung
{
  "recordCount": string
}
Felder
recordCount

string (int64 format)

Die Gesamtzahl der in der Uploadanfrage gesendeten Ereignisse. Enthält alle Ereignisse in der Anfrage, unabhängig davon, ob sie erfolgreich erfasst wurden oder nicht.

RemoveAudienceMembersStatus

Der Status des Antrags zum Entfernen von Zielgruppenmitgliedern.

JSON-Darstellung
{

  // Union field status can be only one of the following:
  "userDataRemovalStatus": {
    object (RemoveUserDataStatus)
  },
  "mobileDataRemovalStatus": {
    object (RemoveMobileDataStatus)
  },
  "pairDataRemovalStatus": {
    object (RemovePairDataStatus)
  }
  // End of list of possible types for union field status.
}
Felder
Union-Feld status. Der Status des Entfernens der Zielgruppenmitglieder aus dem Ziel. Für status ist nur einer der folgenden Werte zulässig:
userDataRemovalStatus

object (RemoveUserDataStatus)

Der Status des Entfernens der Nutzerdaten aus dem Ziel.

mobileDataRemovalStatus

object (RemoveMobileDataStatus)

Der Status des Entfernens der Mobilfunkdaten vom Ziel.

pairDataRemovalStatus

object (RemovePairDataStatus)

Der Status des Entfernens der Paardaten aus dem Ziel.

RemoveUserDataStatus

Der Status des Entfernens der Nutzerdaten aus dem Ziel.

JSON-Darstellung
{
  "recordCount": string,
  "userIdentifierCount": string
}
Felder
recordCount

string (int64 format)

Die Gesamtzahl der Zielgruppenmitglieder, die in der Entfernungssanfrage gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

userIdentifierCount

string (int64 format)

Die Gesamtzahl der Nutzerkennungen, die in der Entfernungsanfrage gesendet wurden. Enthält alle Nutzerkennungen in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

RemoveMobileDataStatus

Der Status des Entfernens der Mobilfunkdaten vom Ziel.

JSON-Darstellung
{
  "recordCount": string,
  "mobileIdCount": string
}
Felder
recordCount

string (int64 format)

Die Gesamtzahl der Zielgruppenmitglieder, die in der Entfernungssanfrage gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

mobileIdCount

string (int64 format)

Die Gesamtzahl der in der Anfrage zum Entfernen gesendeten Mobilgeräte-IDs. Enthält alle Mobilgeräte-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

RemovePairDataStatus

Der Status des Entfernens der Paardaten aus dem Ziel.

JSON-Darstellung
{
  "recordCount": string,
  "pairIdCount": string
}
Felder
recordCount

string (int64 format)

Die Gesamtzahl der Zielgruppenmitglieder, die in der Entfernungssanfrage gesendet wurden. Enthält alle Zielgruppenmitglieder in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.

pairIdCount

string (int64 format)

Die Gesamtzahl der in der Anfrage zum Entfernen gesendeten Paar-IDs. Enthält alle Geräte-IDs in der Anfrage, unabhängig davon, ob sie erfolgreich entfernt wurden oder nicht.