Method: requestStatus.retrieve

تعرض هذه الطريقة حالة طلب معيّن باستخدام رقم تعريف الطلب.

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات طلب البحث

المعلمات
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)

وجهة ضمن طلب البيانات من واجهة برمجة تطبيقات الرسائل المباشرة
requestStatus

enum (RequestStatus)

حالة الطلب الخاص بالوجهة.
errorInfo

object (ErrorInfo)

خطأ في معلومات الخطأ يتضمّن سبب الخطأ وعدد الأخطاء المرتبطة بعملية التحميل
warningInfo

object (WarningInfo)

معلومات تحذيرية تتضمّن سبب التحذير وعدد التحذيرات المرتبطة بعملية التحميل
حقل الدمج status تمثّل هذه السمة حالة الوجهة. يمكن أن تكون status إحدى القيم التالية فقط:
audienceMembersIngestionStatus

object (IngestAudienceMembersStatus)

حالة طلب استيعاب أعضاء شرائح الجمهور.
eventsIngestionStatus

object (IngestEventsStatus)

حالة طلب أحداث الاستيعاب.
audienceMembersRemovalStatus

object (RemoveAudienceMembersStatus)

حالة طلب إزالة أعضاء الجمهور

RequestStatus

حالة الطلب

عمليات التعداد
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

سبب حدوث خطأ في المعالجة

عمليات التعداد
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 تتوفّر إحالة ناجحة بمعرّف النقرة من Google ‏(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 يحتوي معرّف التاجر على أحرف غير رقمية.
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 تعذّر فك تشفير مفتاح تشفير البيانات.
PROCESSING_ERROR_REASON_INVALID_WIP تنسيق WIP غير صحيح أو WIP غير متوفّر.
PROCESSING_ERROR_REASON_INVALID_KEK لا يمكن لمفتاح تشفير المفتاح فك تشفير البيانات لأنّه مفتاح تشفير مفتاح غير صحيح أو غير متوفّر.
PROCESSING_ERROR_REASON_WIP_AUTH_FAILED تعذّر استخدام WIP لأنّه تم رفضه بسبب شرط التصديق.
PROCESSING_ERROR_REASON_KEK_PERMISSION_DENIED لم يكن لدى النظام الأذونات اللازمة للوصول إلى مفتاح تشفير المفاتيح.
PROCESSING_ERROR_REASON_USER_IDENTIFIER_DECRYPTION_ERROR تعذّر فك تشفير بيانات UserIdentifier باستخدام مفتاح تشفير البيانات.
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

سبب التحذير المتعلّق بالمعالجة

عمليات التعداد
PROCESSING_WARNING_REASON_UNSPECIFIED سبب تحذير المعالجة غير معروف.
PROCESSING_WARNING_REASON_KEK_PERMISSION_DENIED لم يكن لدى النظام الأذونات اللازمة للوصول إلى مفتاح تشفير المفاتيح.
PROCESSING_WARNING_REASON_DEK_DECRYPTION_ERROR تعذّر فك تشفير مفتاح تشفير البيانات.
PROCESSING_WARNING_REASON_DECRYPTION_ERROR حدث خطأ في فك تشفير الحدث.
PROCESSING_WARNING_REASON_WIP_AUTH_FAILED تعذّر استخدام WIP لأنّه تم رفضه بسبب شرط التصديق.
PROCESSING_WARNING_REASON_INVALID_WIP تنسيق WIP غير صحيح أو WIP غير متوفّر.
PROCESSING_WARNING_REASON_INVALID_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

نطاق نسبة المطابقة للتحميل أو قائمة المستخدمين

عمليات التعداد
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)

إجمالي عدد أرقام تعريف الأجهزة المقترنة التي تم إرسالها في طلب الإزالة يتضمّن جميع أرقام تعريف الأزواج في الطلب، بغض النظر عمّا إذا تمت إزالتها بنجاح أم لا.