رابط إلى محتوى AMP

يمكنك استخدام واجهة برمجة تطبيقات عناوين URL لصفحات AMP لمطابقة عناوين URL مع عناوين URL المتوافقة مع صفحات AMP، وعرض إصدارات AMP بدلاً من ذلك.

مطابقة عناوين URL بعناوين URL لصفحات AMP

طلب عنوان URL لصفحة AMP من خلال:

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

أدرِج ما يصل إلى 50 عنوان URL كحمولة أساسية في نص الطلب:

{"urls": [
  "https://www.amp.dev",
  "https://www.example.org/article-without-amp-version"
]}

ملاحظة: ليس بالضرورة أن تكون عناوين URL المطلوبة في نماذجها الأساسية.

يجب أن تحتوي جميع الطلبات على مفتاح تطوير من خلال عنوان التفويض X (X-Goog-Api-Key: YOUR-DEVELOPER-KEY). وتكون قيمة سمة التفويض X حساسة لحالة الأحرف. إذا لم يكن لديك مفتاح تطوير، راجِع التفويض للحصول على تعليمات الإعداد.

مثال باستخدام curl:

curl -i -s -k -X POST -H "Content-Type: application/json" -H "X-Goog-Api-Key: " -d "{urls: ['https://example.com']}" "https://acceleratedmobilepageurl.googleapis.com/v1/ampUrls:batchGet"

استبدال عناوين URL بعناوين URL لصفحات AMP

تعرض طريقة batchGet عملية ربط عناوين URL لصفحات AMP بتنسيق JSON:

{ 
  "ampUrls": [
    { 
      "originalUrl": "https://example.com",
      "ampUrl": "https://example.com",
      "cdnAmpUrl": 
         "https://cdn.ampproject.org/c/s/example.com"
    }
  ],
  "urlErrors": [
    { 
      "errorCode": "NO_AMP_URL",
      "errorMessage": "AMP URL not found.",
      "originalUrl": "http://www.example.com/no-amp-version.html"
    }
  ]
}

يتم عرض كل من عنوان URL الأصلي لصفحة AMP والعنوان المخزّن في ذاكرة التخزين المؤقت لصفحات AMP على Google في نص الاستجابة. ننصحك باستخدام "cdnAmpUrl" بدلاً من "ampUrl"، لكي يحصل تطبيقك على جميع مزايا ذاكرة التخزين المؤقت لصفحات AMP على Google.

ملاحظة: يظهر خطأ في حال عدم توفّر عناوين URL لصفحات AMP (راجِع مرجع AmpUrlError).

إعداد عمليات إعادة التوجيه

يمكنك دائمًا إعداد عمليات إعادة التوجيه من المواقع القديمة إلى المواقع الجديدة في أي وقت يتم فيه نقل موقع ملفات AMP على الخادم. تتبع ذاكرة التخزين المؤقت لصفحات AMP على Google عمليات إعادة التوجيه عند حل عناوين URL لصفحات AMP.

إذا كان عنوان URL يعيد التوجيه إلى عنوان URL آخر صالح لصفحات AMP، تعرض ذاكرة التخزين المؤقت لصفحات AMP على Google محتوى إعادة التوجيه الذي تم حله وتخزّنه مؤقتًا.