Method: requestStatus.retrieve

وضعیت یک درخواست داده شده با شناسه درخواست را دریافت می کند.

درخواست HTTP

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

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای پرس و جو

پارامترها
requestId

string

مورد نیاز. مورد نیاز. شناسه درخواست درخواست API Data Manager.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

پاسخ از 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 )

وضعیت درخواست حذف اعضای مخاطب.

وضعیت درخواست

وضعیت درخواست

Enums
REQUEST_STATUS_UNKNOWN وضعیت درخواست نامشخص است.
SUCCESS درخواست با موفقیت انجام شد.
PROCESSING درخواست در حال پردازش است.
FAILED درخواست ناموفق بود.
PARTIAL_SUCCESS درخواست تا حدی موفق شد.

اطلاعات خطا

خطا برای هر نوع خطا محاسبه می شود.

نمایندگی JSON 
{
  "errorCounts": [
    {
      object (ErrorCount)
    }
  ]
}
فیلدها
errorCounts[]

object ( ErrorCount )

فهرستی از خطاها و شمارش در هر دلیل خطا. ممکن است در همه موارد پر جمعیت نباشد.

تعداد خطاها

شمارش خطا برای یک دلیل خطای معین.

نمایندگی JSON 
{
  "recordCount": string,
  "reason": enum (ProcessingErrorReason)
}
فیلدها
recordCount

string ( int64 format)

تعداد رکوردهایی که به دلیل خاصی بارگذاری نشدند.

reason

enum ( ProcessingErrorReason )

دلیل خطای رکوردهای ناموفق.

ProcessingErrorReason

دلیل خطای پردازش

Enums
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 شناسه کلیک گوگل رمزگشایی نشد.
PROCESSING_ERROR_REASON_INVALID_MERCHANT_ID شناسه فروشنده حاوی نویسه‌های غیر رقمی است.
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 اشتباه است یا WIP وجود ندارد.
PROCESSING_ERROR_REASON_INVALID_KEK 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 کاربر تلاش کرد رویدادها را با یک شناسه تبلیغاتی که از تبلیغات حساب عامل نیست وارد کند.

اطلاعات هشدار

هشدار برای هر نوع هشدار به حساب می آید.

نمایندگی JSON 
{
  "warningCounts": [
    {
      object (WarningCount)
    }
  ]
}
فیلدها
warningCounts[]

object ( WarningCount )

فهرستی از اخطارها و شمارش به ازای هر دلیل هشدار.

شمارش هشدار

تعداد اخطارها برای یک دلیل هشدار دهنده مشخص می شود.

نمایندگی JSON 
{
  "recordCount": string,
  "reason": enum (ProcessingWarningReason)
}
فیلدها
recordCount

string ( int64 format)

تعداد رکوردهایی که اخطار دارند.

reason

enum ( ProcessingWarningReason )

دلیل هشدار

ProcessingWarningReason

دلیل هشدار پردازش

Enums
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 اشتباه است یا WIP وجود ندارد.
PROCESSING_WARNING_REASON_INVALID_KEK 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

محدوده نرخ مطابقت آپلود یا فهرست کاربری.

Enums
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)

تعداد کل جفت شناسه های ارسال شده در درخواست حذف. شامل همه شناسه های جفت در درخواست می شود، صرف نظر از اینکه با موفقیت حذف شده اند یا خیر.