Method: requestStatus.retrieve

הפונקציה מקבלת את הסטטוס של בקשה לפי מזהה הבקשה.

בקשת HTTP

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

כתובת ה-URL כתובה בתחביר של gRPC Transcoding.

פרמטרים של שאילתה

פרמטרים
requestId

string

חובה. חובה. מזהה הבקשה של בקשת Data Manager API.

גוף הבקשה

גוף הבקשה צריך להיות ריק.

גוף התשובה

תגובה מRetrieveRequestStatusRequest.

אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:

ייצוג ב-JSON 
{
  "requestStatusPerDestination": [
    {
      object (RequestStatusPerDestination)
    }
  ]
}
שדות
requestStatusPerDestination[]

object (RequestStatusPerDestination)

רשימה של סטטוסי בקשות לכל יעד. סדר הסטטוסים תואם לסדר היעדים בבקשה המקורית.

היקפי הרשאה

נדרש היקף ההרשאות הבא של OAuth:

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

RequestStatusPerDestination

סטטוס בקשה לכל יעד.

ייצוג ב-JSON 
{
  "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.
}
שדות
destination

object (Destination)

יעד בבקשת DM API.
requestStatus

enum (RequestStatus)

סטטוס הבקשה של היעד.
errorInfo

object (ErrorInfo)

שגיאה בפרטי השגיאה שמכילה את סיבת השגיאה ואת מספר השגיאות שקשורות להעלאה.
warningInfo

object (WarningInfo)

מידע על אזהרה שכולל את הסיבה לאזהרה ואת מספר האזהרות שקשורות להעלאה.
שדה איחוד status. הסטטוס של היעד. הערך status יכול להיות רק אחד מהבאים:
audienceMembersIngestionStatus

object (IngestAudienceMembersStatus)

הסטטוס של הבקשה להוספת חברים לקהל.
eventsIngestionStatus

object (IngestEventsStatus)

הסטטוס של הבקשה להוספת אירועים.
audienceMembersRemovalStatus

object (RemoveAudienceMembersStatus)

הסטטוס של הבקשה להסרת חברים מקהל.

RequestStatus

סטטוס הבקשה.

טיפוסים בני מנייה (enum)
REQUEST_STATUS_UNKNOWN סטטוס הבקשה לא ידוע.
SUCCESS הבקשה הושלמה בהצלחה.
PROCESSING הבקשה נמצאת בתהליך.
FAILED הבקשה נכשלה.
PARTIAL_SUCCESS הבקשה הצליחה באופן חלקי.

ErrorInfo

מספר השגיאות לכל סוג שגיאה.

ייצוג ב-JSON 
{
  "errorCounts": [
    {
      object (ErrorCount)
    }
  ]
}
שדות
errorCounts[]

object (ErrorCount)

רשימה של שגיאות וספירות לפי סיבת השגיאה. יכול להיות שהשדה לא יאוכלס בכל המקרים.

ErrorCount

מספר השגיאות לסיבת שגיאה נתונה.

ייצוג ב-JSON 
{
  "recordCount": string,
  "reason": enum (ProcessingErrorReason)
}
שדות
recordCount

string (int64 format)

מספר הרשומות שההעלאה שלהן נכשלה בגלל סיבה מסוימת.
reason

enum (ProcessingErrorReason)

סיבת השגיאה של הרשומות שנכשלו.

ProcessingErrorReason

הסיבה לשגיאת העיבוד.

טיפוסים בני מנייה (enum)
PROCESSING_ERROR_REASON_UNSPECIFIED הסיבה לשגיאת העיבוד לא ידועה.
PROCESSING_ERROR_REASON_INVALID_CUSTOM_VARIABLE המשתנה המותאם אישית לא תקין.
PROCESSING_ERROR_REASON_CUSTOM_VARIABLE_NOT_ENABLED הסטטוס של המשתנה המותאם אישית לא מוגדר כ'מופעל'.
PROCESSING_ERROR_REASON_EVENT_TOO_OLD ההמרה ישנה יותר מהגיל המקסימלי הנתמך.
PROCESSING_ERROR_REASON_DUPLICATE_GCLID כבר קיימת במערכת המרה עם אותו GCLID ואותו מועד המרה.
PROCESSING_ERROR_REASON_DUPLICATE_TRANSACTION_ID כבר העליתם המרה עם שילוב זהה של מזהה הזמנה ופעולת המרה.
PROCESSING_ERROR_REASON_INVALID_GBRAID לא ניתן לפענח את ה-GBRAID.
PROCESSING_ERROR_REASON_INVALID_GCLID לא הצלחנו לפענח את מספר הקליק ב-Google.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID מספר החשבון Merchant מכיל תווים שהם לא ספרות.
PROCESSING_ERROR_REASON_INVALID_WBRAID לא ניתן היה לפענח את ה-wbraid.
PROCESSING_ERROR_REASON_INTERNAL_ERROR שגיאה פנימית.
PROCESSING_ERROR_REASON_DESTINATION_ACCOUNT_ENHANCED_CONVERSIONS_TERMS_NOT_SIGNED התנאים של ההמרות המשופרות לא נחתמו בחשבון היעד.
PROCESSING_ERROR_REASON_INVALID_EVENT האירוע לא תקין.
PROCESSING_ERROR_REASON_INSUFFICIENT_MATCHED_TRANSACTIONS מספר העסקאות התואמות נמוך מסף המינימום.
PROCESSING_ERROR_REASON_INSUFFICIENT_TRANSACTIONS העסקאות נמוכות מסכום הסף המינימלי.
PROCESSING_ERROR_REASON_INVALID_FORMAT יש שגיאת פורמט באירוע.
PROCESSING_ERROR_REASON_DECRYPTION_ERROR יש שגיאת פענוח באירוע.
PROCESSING_ERROR_REASON_DEK_DECRYPTION_ERROR פענוח המפתח להצפנת נתונים (DEK) נכשל.
PROCESSING_ERROR_REASON_INVALID_WIP ה-WIP לא בפורמט הנכון או שהוא לא קיים.
PROCESSING_ERROR_REASON_INVALID_KEK המפתח להצפנת מפתחות הצפנה (KEK) לא יכול לפענח נתונים כי הוא לא נכון או לא קיים.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED אי אפשר להשתמש ב-WIP כי הוא נדחה על ידי תנאי האימות שלו.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED למערכת לא היו ההרשאות שנדרשות כדי לגשת ל-KEK.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR פענוח הנתונים של UserIdentifier באמצעות המפתח להצפנת נתונים (DEK) נכשל.
PROCESSING_ERROR_OPERATING_ACCOUNT_MISMATCH_FOR_AD_IDENTIFIER המשתמש ניסה להעביר אירועים עם מזהה פרסום שלא שייך למודעות של החשבון הפעיל.

WarningInfo

מספר האזהרות לכל סוג אזהרה.

ייצוג ב-JSON 
{
  "warningCounts": [
    {
      object (WarningCount)
    }
  ]
}
שדות
warningCounts[]

object (WarningCount)

רשימה של אזהרות וספירות לפי הסיבה לאזהרה.

WarningCount

מספר האזהרות שקשורות לסיבה מסוימת.

ייצוג ב-JSON 
{
  "recordCount": string,
  "reason": enum (ProcessingWarningReason)
}
שדות
recordCount

string (int64 format)

מספר הרשומות שכוללות אזהרה.
reason

enum (ProcessingWarningReason)

הסיבה לאזהרה.

ProcessingWarningReason

הסיבה לאזהרת העיבוד.

טיפוסים בני מנייה (enum)
PROCESSING_WARNING_REASON_UNSPECIFIED הסיבה לאזהרת העיבוד לא ידועה.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED למערכת לא היו ההרשאות שנדרשות כדי לגשת ל-KEK.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR פענוח המפתח להצפנת נתונים (DEK) נכשל.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR יש שגיאת פענוח באירוע.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED אי אפשר להשתמש ב-WIP כי הוא נדחה על ידי תנאי האימות שלו.
PROCESSING_WARNING_REASON_INVALID_WIP ה-WIP לא בפורמט הנכון או שהוא לא קיים.
PROCESSING_WARNING_REASON_INVALID_KEK המפתח להצפנת מפתחות הצפנה (KEK) לא יכול לפענח נתונים כי הוא לא נכון או לא קיים.
PROCESSING_WARNING_REASON_USER_IDENTIFIER_DECRYPTION_ERROR פענוח הנתונים של UserIdentifier באמצעות המפתח להצפנת נתונים (DEK) נכשל.
PROCESSING_WARNING_REASON_INTERNAL_ERROR שגיאה פנימית.

IngestAudienceMembersStatus

הסטטוס של הבקשה להוספת חברים לקהל.

ייצוג ב-JSON 
{

  // 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.
}
שדות
שדה איחוד status. הסטטוס של העברת החברים בקהל היעד ליעד. הערך status יכול להיות רק אחד מהבאים:
userDataIngestionStatus

object (IngestUserDataStatus)

הסטטוס של הטמעת נתוני המשתמש ביעד.
mobileDataIngestionStatus

object (IngestMobileDataStatus)

הסטטוס של ההעברה של חבילת הגלישה אל היעד.
pairDataIngestionStatus

object (IngestPairDataStatus)

הסטטוס של הטמעת נתוני הצמדים ביעד.

IngestUserDataStatus

הסטטוס של ההעברה של נתוני המשתמש ליעד שמכיל נתונים סטטיסטיים שקשורים להעברה.

ייצוג ב-JSON 
{
  "recordCount": string,
  "userIdentifierCount": string,
  "uploadMatchRateRange": enum (MatchRateRange)
}
שדות
recordCount

string (int64 format)

המספר הכולל של חברי הקהל שנשלח בבקשת ההעלאה ליעד. הבקשה כוללת את כל חברי הקהל, בלי קשר לשאלה אם הם נכללו בהצלחה או לא.
userIdentifierCount

string (int64 format)

המספר הכולל של מזהי משתמשים שנשלחו בבקשת ההעלאה ליעד. כולל את כל מזהי המשתמשים בבקשה, בלי קשר לשאלה אם הם נבלעו בהצלחה או לא.
uploadMatchRateRange

enum (MatchRateRange)

טווח אחוז הלקוחות לטירגוט בהעלאה.

MatchRateRange

טווח אחוז הלקוחות לטירגוט של ההעלאה או של רשימת המשתמשים.

טיפוסים בני מנייה (enum)
MATCH_RATE_RANGE_UNKNOWN טווח שיעור ההתאמה לא ידוע.
MATCH_RATE_RANGE_NOT_ELIGIBLE הטווח של שיעור ההתאמה לא עומד בדרישות.
MATCH_RATE_RANGE_LESS_THAN_20 טווח אחוז הלקוחות לטירגוט הוא פחות מ-20% (במרווח [0, 20)).
MATCH_RATE_RANGE_20_TO_30 טווח שיעור ההתאמה הוא בין 20% ל-30% (במרווח [20, 31)).
MATCH_RATE_RANGE_31_TO_40 טווח שיעור ההתאמה הוא בין 31% ל-40% (במרווח [31, 41)).
MATCH_RATE_RANGE_41_TO_50 טווח שיעור ההתאמה הוא בין 41% ל-50% (במרווח [41, 51)).
MATCH_RATE_RANGE_51_TO_60 טווח שיעור ההתאמה הוא בין 51% ל-60% (במרווח [51, 61).
MATCH_RATE_RANGE_61_TO_70 טווח שיעור ההתאמה הוא בין 61% ל-70% (במרווח [61, 71)).
MATCH_RATE_RANGE_71_TO_80 טווח שיעור ההתאמה הוא בין 71% ל-80% (במרווח [71, 81)).
MATCH_RATE_RANGE_81_TO_90 טווח שיעור ההתאמה הוא בין 81% ל-90% (במרווח [81, 91)).
MATCH_RATE_RANGE_91_TO_100

טווח שיעור ההתאמה הוא בין 91% ל-100% (במרווח [91, 100]).

IngestMobileDataStatus

הסטטוס של ההעברה של חבילת הגלישה ליעד שמכיל נתונים סטטיסטיים שקשורים להעברה.

ייצוג ב-JSON 
{
  "recordCount": string,
  "mobileIdCount": string
}
שדות
recordCount

string (int64 format)

המספר הכולל של חברי הקהל שנשלח בבקשת ההעלאה ליעד. הבקשה כוללת את כל חברי הקהל, בלי קשר לשאלה אם הם נכללו בהצלחה או לא.
mobileIdCount

string (int64 format)

המספר הכולל של מזהי מכשירים ניידים שנשלחו בבקשת ההעלאה ליעד. כולל את כל המזהים של מכשירים ניידים בבקשה, בין אם הם הוטמעו בהצלחה ובין אם לא.

IngestPairDataStatus

הסטטוס של ההעברה של נתוני הזוג ליעד שמכיל נתונים סטטיסטיים שקשורים להעברה.

ייצוג ב-JSON 
{
  "recordCount": string,
  "pairIdCount": string
}
שדות
recordCount

string (int64 format)

המספר הכולל של חברי הקהל שנשלח בבקשת ההעלאה ליעד. הבקשה כוללת את כל חברי הקהל, בלי קשר לשאלה אם הם נכללו בהצלחה או לא.
pairIdCount

string (int64 format)

המספר הכולל של מזהי זוגות שנשלחו בבקשת ההעלאה ליעד. המספר כולל את כל מזהי הזוגות בבקשה, בלי קשר לשאלה אם הם הוטמעו בהצלחה או לא.

IngestEventsStatus

הסטטוס של ההעברה של האירועים ליעד.

ייצוג ב-JSON 
{
  "recordCount": string
}
שדות
recordCount

string (int64 format)

המספר הכולל של האירועים שנשלחו בבקשת ההעלאה. כולל את כל האירועים בבקשה, בלי קשר לשאלה אם הם נקלטו בהצלחה או לא.

RemoveAudienceMembersStatus

הסטטוס של הבקשה להסרת חברים מקהל.

ייצוג ב-JSON 
{

  // 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.
}
שדות
שדה איחוד status. הסטטוס של הסרת חברי הקהל מהיעד. הערך status יכול להיות רק אחד מהבאים:
userDataRemovalStatus

object (RemoveUserDataStatus)

הסטטוס של הסרת נתוני המשתמש מהיעד.
mobileDataRemovalStatus

object (RemoveMobileDataStatus)

הסטטוס של הסרת חבילת הגלישה מהיעד.
pairDataRemovalStatus

object (RemovePairDataStatus)

הסטטוס של הסרת נתוני הזיווג מהיעד.

RemoveUserDataStatus

הסטטוס של הסרת נתוני המשתמש מהיעד.

ייצוג ב-JSON 
{
  "recordCount": string,
  "userIdentifierCount": string
}
שדות
recordCount

string (int64 format)

המספר הכולל של חברי הקהל שנשלח בבקשת ההסרה. כולל את כל חברי הקהל בבקשה, בין אם הם הוסרו בהצלחה ובין אם לא.
userIdentifierCount

string (int64 format)

המספר הכולל של מזהי משתמשים שנשלחו בבקשת ההסרה. כולל את כל מזהי המשתמשים בבקשה, בלי קשר להצלחת ההסרה.

RemoveMobileDataStatus

הסטטוס של הסרת חבילת הגלישה מהיעד.

ייצוג ב-JSON 
{
  "recordCount": string,
  "mobileIdCount": string
}
שדות
recordCount

string (int64 format)

המספר הכולל של חברי הקהל שנשלח בבקשת ההסרה. כולל את כל חברי הקהל בבקשה, בין אם הם הוסרו בהצלחה ובין אם לא.
mobileIdCount

string (int64 format)

המספר הכולל של מזהי מכשירים ניידים שנשלחו בבקשה להסרה. כולל את כל מזהי המכשירים הניידים בבקשה, בין אם הם הוסרו בהצלחה ובין אם לא.

RemovePairDataStatus

הסטטוס של הסרת נתוני הזיווג מהיעד.

ייצוג ב-JSON 
{
  "recordCount": string,
  "pairIdCount": string
}
שדות
recordCount

string (int64 format)

המספר הכולל של חברי הקהל שנשלח בבקשת ההסרה. כולל את כל חברי הקהל בבקשה, בין אם הם הוסרו בהצלחה ובין אם לא.
pairIdCount

string (int64 format)

המספר הכולל של מזהי הזוגות שנשלחו בבקשת ההסרה. כולל את כל מזהי הזוגות בבקשה, בלי קשר לשאלה אם הם הוסרו בהצלחה או לא.