يجب أن تحتوي جميع الطلبات على مفتاح تطوير من خلال عنوان التفويض X
(X-Goog-Api-Key: YOUR-DEVELOPER-KEY).
وتكون قيمة سمة التفويض X حساسة لحالة الأحرف.
إذا لم يكن لديك مفتاح تطوير،
راجِع التفويض للحصول على تعليمات الإعداد.
يتم عرض كل من عنوان URL الأصلي لصفحة AMP
والعنوان المخزّن في ذاكرة التخزين المؤقت لصفحات AMP على Google
في نص الاستجابة.
ننصحك باستخدام "cdnAmpUrl" بدلاً من "ampUrl"،
لكي يحصل تطبيقك على جميع
مزايا ذاكرة التخزين المؤقت لصفحات AMP على Google.
إعداد عمليات إعادة التوجيه
يمكنك دائمًا إعداد عمليات إعادة التوجيه من المواقع القديمة إلى المواقع الجديدة في أي وقت يتم فيه نقل موقع ملفات AMP على الخادم.
تتبع ذاكرة التخزين المؤقت لصفحات AMP على Google عمليات إعادة التوجيه عند حل عناوين URL لصفحات AMP.
إذا كان عنوان URL يعيد التوجيه إلى عنوان URL آخر صالح لصفحات AMP،
تعرض ذاكرة التخزين المؤقت لصفحات AMP على Google محتوى إعادة التوجيه الذي تم حله وتخزّنه مؤقتًا.
تاريخ التعديل الأخير: 2023-08-30 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2023-08-30 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eUtilize the AMP URL API to find corresponding AMP URLs and serve those versions to users.\u003c/p\u003e\n"],["\u003cp\u003eThe API allows matching up to 50 URLs at once by sending a POST request with a JSON payload containing the URLs.\u003c/p\u003e\n"],["\u003cp\u003eInclude a developer key in the request header for authorization purposes.\u003c/p\u003e\n"],["\u003cp\u003eThe API response provides both the original AMP URL and the Google AMP Cache URL; prioritize using the cached version (\u003ccode\u003ecdnAmpUrl\u003c/code\u003e).\u003c/p\u003e\n"],["\u003cp\u003eImplement redirects for moved AMP files to ensure proper resolution by the Google AMP Cache.\u003c/p\u003e\n"]]],["To obtain AMP URLs, use the AMP URL API's `batchGet` method via a POST request to `acceleratedmobilepageurl.googleapis.com/v1/ampUrls:batchGet`. Include up to 50 URLs in the request body and a developer key in the `X-Goog-Api-Key` header. The response will provide a JSON mapping, including original and CDN AMP URLs. It's recommended to use `\"cdnAmpUrl\"`. Set up redirects for moved AMP files to ensure the Google AMP Cache resolves and caches the correct content.\n"],null,["# Link to AMP Content\n\nUse the [AMP URL API](/amp/cache/reference/acceleratedmobilepageurl/rest)\nto match URLs to corresponding AMP URLs,\nand serve the AMP versions instead.\n\nMatch URLs to AMP URLs\n----------------------\n\nRequest an AMP URL via: \n\n```\nPOST https://acceleratedmobilepageurl.googleapis.com/v1/ampUrls:batchGet\n```\n\nList [up to 50 URLs](/amp/cache/reference/limits)\nas payload in the request body: \n\n```\n{\"urls\": [\n \"https://www.amp.dev\",\n \"https://www.example.org/article-without-amp-version\"\n]}\n```\n| **Note:** The requested URLs do not need to be in their [canonical forms](https://amp.dev/documentation/guides-and-tutorials/optimize-and-measure/discovery).\n\n\nAll requests need to include a development key via X-Authorization header\n(`X-Goog-Api-Key: YOUR-DEVELOPER-KEY`).\nThe X-Authorization header value is case sensitive.\nIf you don't have a development key,\nsee [Authorization](/amp/cache/reference/authorizing) for setup instructions.\n\n\nExample using curl: \n\n```\ncurl -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\"\n```\n\nReplace URLs with AMP URLs\n--------------------------\n\nThe [`batchGet` method](/amp/cache/reference/acceleratedmobilepageurl/rest/v1/ampUrls/batchGet)\nreturns the AMP URL mapping in JSON: \n\n```\n{ \n \"ampUrls\": [\n { \n \"originalUrl\": \"https://example.com\",\n \"ampUrl\": \"https://example.com\",\n \"cdnAmpUrl\": \n \"https://cdn.ampproject.org/c/s/example.com\"\n }\n ],\n \"urlErrors\": [\n { \n \"errorCode\": \"NO_AMP_URL\",\n \"errorMessage\": \"AMP URL not found.\",\n \"originalUrl\": \"http://www.example.com/no-amp-version.html\"\n }\n ]\n}\n```\n\n\nBoth the original AMP URL\nand the one stored in the Google AMP Cache\nget returned in the\n[response body](/amp/cache/reference/acceleratedmobilepageurl/rest/v1/ampUrls/batchGet#response-body).\nWe encourage you to use `\"cdnAmpUrl\"`, instead of `\"ampUrl\"`,\nso that your application can have all\n[the benefits of the Google AMP Cache](/amp/cache/overview).\n| **Note:** An error is thrown if no AMP URLs exist (see the [`AmpUrlError` reference](/amp/cache/reference/acceleratedmobilepageurl/rest/v1/ampUrls/batchGet#ampurlerror)).\n\nSet up redirects\n----------------\n\nAny time you move the location of AMP files on your server,\nset up redirects from old locations to new locations.\nThe Google AMP Cache follows redirects when resolving AMP URLs.\n\nIf a URL redirects to another valid AMP URL,\nthe Google AMP Cache returns and caches the content of the resolved redirect."]]