Toutes les requêtes doivent inclure une clé de développement dans l'en-tête X-Authorization (X-Goog-Api-Key: YOUR-DEVELOPER-KEY). La valeur de l'en-tête X-Authorization est sensible à la casse.
Si vous n'avez pas de clé de développement, des instructions de configuration sont disponibles sur la page consacrée aux autorisations.
L'URL AMP d'origine et celle qui est stockée dans Google AMP Cache s'affichent dans le corps de la réponse.
Nous vous conseillons d'utiliser "cdnAmpUrl" plutôt que "ampUrl", afin que votre application puisse bénéficier de tous les avantages de Google AMP Cache.
Configurer des redirections
Chaque fois que vous déplacez des fichiers AMP sur votre serveur, configurez des redirections depuis les anciens emplacements vers les nouveaux.
Google AMP Cache se base sur les redirections lors de la résolution des URL AMP.
Si une URL redirige vers une autre URL AMP valide, Google AMP Cache affiche et met en cache le contenu obtenu à l'issue de la résolution de la redirection.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/08/04 (UTC).
[[["Facile à comprendre","easyToUnderstand","thumb-up"],["J'ai pu résoudre mon problème","solvedMyProblem","thumb-up"],["Autre","otherUp","thumb-up"]],[["Il n'y a pas l'information dont j'ai besoin","missingTheInformationINeed","thumb-down"],["Trop compliqué/Trop d'étapes","tooComplicatedTooManySteps","thumb-down"],["Obsolète","outOfDate","thumb-down"],["Problème de traduction","translationIssue","thumb-down"],["Mauvais exemple/Erreur de code","samplesCodeIssue","thumb-down"],["Autre","otherDown","thumb-down"]],["Dernière mise à jour le 2025/08/04 (UTC)."],[[["\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."]]