Method: ampUrls.batchGet

מחזירה כתובות URL של AMP וכתובות URL במטמון במטמון.

בקשת 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. ייתכן שהתגובה לא תהיה זהה לזו של כתובות ה-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 מדלגת על מסמכים פעילים של כתובות אתרים שלא נמצאו באינדקס. לאפליקציות שבהן נדרש זמן אחזור קצר באסטרטגיה של IN_INDEX_DOC.

כתובת URL של AMP

תגובה של כתובת URL מסוג AMP לכתובת URL מבוקשת.

ייצוג JSON 
{
  "originalUrl": string,
  "ampUrl": string,
  "cdnAmpUrl": string,
}
שדות
originalUrl

string

כתובת ה-URL המקורית שאינה בפורמט AMP.

ampUrl

string

כתובת ה-URL של ה-AMP שמפנה לשרת האינטרנט של בעל התוכן הדיגיטלי.

cdnAmpUrl

string

כתובת ה-URL של מטמון ה-AMP שמפנה למסמך שבמטמון במטמון Google AMP.

שגיאת AmpUrl

משאב שגיאה של כתובת אתר AMP שלא ניתן למצוא.

ייצוג 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 תקין.

רוצה לנסות?