Method: ampUrls.batchGet

عرض عناوين URL لصفحات AMP وعناوين URL لذاكرة التخزين المؤقت لصفحات AMP المكافئة.

طلب HTTP

POST https://acceleratedmobilepageurl.googleapis.com/v1/ampUrls:batchGet

يستخدِم عنوان URL بنية تعليق توضيحي عبر HTTP لواجهة Google API.

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
الحقول
urls[]

string

قائمة بعناوين URL التي يتم البحث عنها في عناوين URL لصفحات AMP المقترنة، علمًا بأن عناوين URL حساسة لحالة الأحرف. ما يصل إلى 50 عنوان URL لكل عملية بحث (راجِع حدود الاستخدام).

lookupStrategy

enum(LookupStrategy)

استراتيجية البحث المطلوبة.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

الاستجابة المجمّعة لعناوين URL لصفحات AMP

تمثيل JSON 
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
الحقول
ampUrls[]

object(AmpUrl)

الاستجابة لكل عنوان URL في BatchAmpUrlsRequest. قد لا تكون الاستجابة بالترتيب نفسه الذي تأتي به عناوين URL في الطلب المجمّع. إذا كان BatchAmpUrlsRequest يحتوي على عناوين URL مكرّرة، يتم إنشاء AmpUrl مرة واحدة فقط.

urlErrors[]

object(AmpUrlError)

أخطاء عناوين URL المطلوبة التي لا تتضمّن عنوان URL لصفحة AMP

استراتيجية البحث

عمليات التعداد
FETCH_LIVE_DOC تشتمل استراتيجية FETCH_LIVE_DOC على استرجاع المستندات مباشرةً من عناوين URL التي لم يتم العثور عليها في الفهرس. يتم الزحف في أي وقت إلى أي عنوان URL لطلب لم يتم العثور عليه في الفهرس للتحقّق مما إذا كان هناك عنوان URL مقابل AMP. تتميز هذه الاستراتيجية بتغطية أعلى، ولكن يتم إدخال وقت استجابة إضافي من خلال الزحف في الوقت الفعلي. وهذه هي الاستراتيجية التلقائية. يجب أن تضبط التطبيقات التي تستخدم هذه الاستراتيجية مهلات HTTP أعلى لاستدعاءات واجهة برمجة التطبيقات.
IN_INDEX_DOC تتجاوز استراتيجية IN_INDEX_DOC استرجاع المستندات المباشرة لعناوين URL التي لم يتم العثور عليها في الفهرس. بالنسبة إلى التطبيقات التي تحتاج إلى استخدام وقت استجابة منخفض في استراتيجية IN_INDEX_DOC.

AmpUrl

استجابة عنوان URL لصفحات AMP لعنوان URL مطلوب

تمثيل JSON 
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
الحقول
originalUrl

string

عنوان URL الأصلي بغير تنسيق AMP.

ampUrl

string

عنوان URL لصفحة AMP الذي يشير إلى خادم الويب للناشر.

cdnAmpUrl

string

عنوان URL لذاكرة التخزين المؤقت لصفحات AMP الذي يشير إلى المستند المخزّن مؤقتًا في ذاكرة التخزين المؤقت لصفحات AMP على Google

خطأ AmpUrl

تعذّر العثور على مورد الخطأ لعنوان URL لصفحة AMP لعنوان URL المطلوب الذي تعذّر العثور عليه.

تمثيل JSON 
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
الحقول
errorCode

enum(ErrorCode)

رمز الخطأ في طلب بيانات من واجهة برمجة التطبيقات

errorMessage

string

رسالة خطأ وصفية اختيارية.

originalUrl

string

عنوان URL الأصلي بغير تنسيق AMP.

رمز الخطأ

رموز الخطأ للبحث المجمّع عن عناوين URL لصفحات AMP.

عمليات التعداد
ERROR_CODE_UNSPECIFIED لم يتم تحديد الخطأ.
INPUT_URL_NOT_FOUND تشير هذه القيمة إلى عدم العثور على عنوان URL المطلوب في الفهرس، وقد يكون السبب هو تعذُّر العثور عليه أو تعذُّر وصول Googlebot إليه أو حدوث خطأ آخر.
NO_AMP_URL تشير إلى عدم العثور على عنوان URL لصفحة AMP يتوافق مع عنوان URL المطلوب.
APPLICATION_ERROR يشير إلى نوع من أخطاء التطبيق التي حدثت على الخادم. يُنصح العميل بإعادة المحاولة.
URL_IS_VALID_AMP تم الإيقاف: يشير إلى أن عنوان URL المطلوب هو عنوان URL صالح لصفحات AMP. وهذه الحالة ليست متعلقة بخطأ، ويجب عدم الاعتماد عليها كدليل على نجاح العملية أو فشلها. وستتم إزالته في الإصدارات المستقبلية من واجهة برمجة التطبيقات.
URL_IS_INVALID_AMP يشير إلى أنّه تم العثور على عنوان URL لصفحة AMP يتوافق مع عنوان URL للطلب، ولكنه غير صالح.

جرِّب هذه الميزة الآن.