Method: ampUrls.batchGet

URL(های) AMP و URL(های) حافظه کش AMP معادل را برمی گرداند.

درخواست HTTP

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

URL از نحو حاشیه نویسی Google API HTTP استفاده می کند.

درخواست بدن

بدنه درخواست شامل داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "urls": [
    string
  ]
  "lookupStrategy": enum(LookupStrategy),
}
زمینه های
urls[]

string

فهرست نشانی‌های اینترنتی برای جستجوی نشانی‌های اینترنتی AMP جفت‌شده. URL ها به حروف کوچک و بزرگ حساس هستند. حداکثر 50 URL در هر جستجو (به محدودیت های استفاده مراجعه کنید).

lookupStrategy

enum( LookupStrategy )

جستجو استراتژی درخواست شده است.

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

پاسخ URL دسته ای AMP.

نمایندگی JSON
{
  "ampUrls": [
    {
      object(AmpUrl)
    }
  ],
  "urlErrors": [
    {
      object(AmpUrlError)
    }
  ],
}
زمینه های
ampUrls[]

object( AmpUrl )

برای هر URL در BatchAmpUrlsRequest، پاسخ URL. پاسخ ممکن است به ترتیب URL های موجود در درخواست دسته ای نباشد. اگر BatchAmpUrlsRequest حاوی URL های تکراری باشد، AmpUrl تنها یک بار تولید می شود.

urlErrors[]

object( AmpUrlError )

خطاهای URL های درخواستی که فاقد URL AMP هستند.

استراتژی جستجو

Enums
FETCH_LIVE_DOC استراتژی FETCH_LIVE_DOC شامل واکشی سند زنده از URLهایی است که در فهرست یافت نمی شوند. هر URL درخواستی که در فهرست یافت نمی‌شود، در زمان واقعی خزیده می‌شود تا در صورت وجود نشانی اینترنتی AMP مربوطه، اعتبارسنجی شود. این استراتژی پوشش بالاتری دارد اما با تأخیر اضافی که توسط خزیدن بیدرنگ معرفی شده است. این استراتژی پیش فرض است. برنامه‌هایی که از این استراتژی استفاده می‌کنند باید زمان‌های HTTP بالاتری را برای تماس‌های API تنظیم کنند.
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

نشانی اینترنتی AMP که به سرور وب ناشر اشاره می کند.

cdnAmpUrl

string

نشانی اینترنتی حافظه پنهان AMP که به سند ذخیره شده در حافظه پنهان Google AMP اشاره می کند.

AmpUrlError

منبع خطای URL AMP برای URL درخواستی که پیدا نشد.

نمایندگی JSON
{
  "errorCode": enum(ErrorCode),
  "errorMessage": string,
  "originalUrl": string,
}
زمینه های
errorCode

enum( ErrorCode )

کد خطای تماس API.

errorMessage

string

یک پیام خطای توصیفی اختیاری.

originalUrl

string

URL اصلی غیر AMP.

کد خطا

کدهای خطا برای جستجوی دسته ای URL AMP.

Enums
ERROR_CODE_UNSPECIFIED خطای مشخص نشده
INPUT_URL_NOT_FOUND نشان می‌دهد URL درخواستی در فهرست یافت نمی‌شود، احتمالاً به این دلیل که نمی‌توان آن را پیدا کرد، Googlebot نمی‌تواند به آن دسترسی پیدا کند، یا برخی از خطاهای دیگر.
NO_AMP_URL نشان می دهد هیچ URL AMP مطابق با URL درخواستی پیدا نشده است.
APPLICATION_ERROR نشان دهنده نوعی خطای برنامه در سرور است. به مشتری توصیه شد دوباره امتحان کنید.
URL_IS_VALID_AMP منسوخ شده: نشان می دهد که URL درخواستی یک URL معتبر AMP است. این یک حالت بدون خطا است، نباید به عنوان نشانه ای از موفقیت یا شکست به آن اعتماد کرد. در نسخه های بعدی API حذف خواهد شد.
URL_IS_INVALID_AMP نشان می دهد که یک URL AMP پیدا شده است که با URL درخواست مطابقت دارد، اما AMP HTML معتبر نیست.

آن را امتحان کنید!