Get an Apple Messages template version's language
/v1/amb/templates/{template_ref}/versions/{version_id}/languages/{language}const language = await bird.amb.templates.versions.languages.get(
"bird_order_update",
"amv_01ky4x8e4genzb7way45txfkm1",
"en",
);
console.log(language.language, language.text);language = client.amb.templates.versions.languages.get(
"bird_order_update", "amv_01ky4x8e4genzb7way45txfkm1", "en"
)
print(language.language, language.text)language, err := client.Amb.Templates.Versions.Languages.Get(context.Background(), "bird_order_update", "amv_01ky4x8e4genzb7way45txfkm1", "en")
if err != nil {
log.Fatal(err)
}
fmt.Println(language.Language, language.Text)$language = $bird->amb->templates->versions->languages->get(
'bird_order_update',
'amv_01ky4x8e4genzb7way45txfkm1',
'en',
);
echo $language->getLanguage(), ' ', $language->getRevision();bird amb templates versions languages get <template-ref> <version-id> <language>curl -X GET "https://us1.platform.bird.com/v1/amb/templates/{template_ref}/versions/{version_id}/languages/{language}" \
-H "Authorization: Bearer $TOKEN"{
"language": "en",
"text": {
"body": "Your order {{ order_number }} is on its way."
},
"revision": 1,
"content_hash": "sha256:3d948846f5f773fb7bed8ab81b57f3d0ff2cbff24cb549718f4d389f1ab0300a",
"updated_at": "2026-09-10T09:00:00Z"
}
Returns one language's full text, revision, content hash, and update time. The response echoes the language in its canonical BCP-47 form.
Paramètres
template_refstringThe template's ID (amt_…) or slug.
version_idstringThe version that holds the language.
languagestringThe language as a BCP-47 tag. Case and separator differences are accepted and canonicalized.
Contenu de la réponse
languageThe language in canonical BCP-47 form.
textStored text and files. Includes its {{ variable }} placeholders.
Afficher les attributs enfants
text.bodyText displayed in the message. Use one U+FFFC object replacement character per attachment to control placement.
text.subjectSubject displayed above the message body.
text.link_previewsHow the links in body of a message you send are previewed. Each https://, http:// or www. link is sent as its own rich link, built from the linked page's title and image. Punctuation that ends a link's sentence is dropped, so it does not arrive on its own after the card.
For the image, the page's og:image is tried first, then its largest apple-touch-icon or icon, then the largest image in the page. layout applies to every preview in the message: icon and square try the icon first, and large tries the images in the page before the icon.
Only a text sent on its own can set link_previews. A request that sets it beside rich_link or interactive is refused with 422. Leave it out there, and links in that text become previews in the default layout.
A message is accepted and then ends send_failed when:
- It has more than 20 links.
- A page does not load over HTTPS, or has no title or usable image. Every page is fetched over HTTPS, upgrading
http://andwww.links.
Every link is checked before the first part is sent, so the customer receives none of the message. A retry after some parts were delivered checks only the parts still to send, so a link that stops loading by then fails the message after those parts arrived.
Afficher les attributs enfants
text.link_previews.layoutHow Apple displays a rich link's image. Apple picks the layout from the image's shape and width, so the image is resized or cropped to produce the one you choose:
iconshows a small image beside the title. The image is scaled to under 150 px wide. Use it for logos.squareshows a square image. The image is cropped to a square and sized to 240 px, or as small as 150 px when it needs to fit Apple's 200 kB limit.largeshows a wide image. A square or portrait image is cropped to a 2:1 rectangle, and a landscape image keeps its shape.
square enlarges an image whose shorter side is under 240 px, and large one narrower than 240 px, which can blur it. Omit layout to keep the image's own shape, so Apple picks the layout from its shape and width.
Possible values: icon, square, large
text.subjectSubject displayed above the message body.
text.attachmentsOrdered attachments. A send supplies each one by source_url or attachment_id.
text.link_previewsHow the links in body of a message you send are previewed. Each https://, http:// or www. link is sent as its own rich link, built from the linked page's title and image. Punctuation that ends a link's sentence is dropped, so it does not arrive on its own after the card.
For the image, the page's og:image is tried first, then its largest apple-touch-icon or icon, then the largest image in the page. layout applies to every preview in the message: icon and square try the icon first, and large tries the images in the page before the icon.
Only a text sent on its own can set link_previews. A request that sets it beside rich_link or interactive is refused with 422. Leave it out there, and links in that text become previews in the default layout.
A message is accepted and then ends send_failed when:
- It has more than 20 links.
- A page does not load over HTTPS, or has no title or usable image. Every page is fetched over HTTPS, upgrading
http://andwww.links.
Every link is checked before the first part is sent, so the customer receives none of the message. A retry after some parts were delivered checks only the parts still to send, so a link that stops loading by then fails the message after those parts arrived.
Afficher les attributs enfants
text.link_previews.layoutHow Apple displays a rich link's image. Apple picks the layout from the image's shape and width, so the image is resized or cropped to produce the one you choose:
iconshows a small image beside the title. The image is scaled to under 150 px wide. Use it for logos.squareshows a square image. The image is cropped to a square and sized to 240 px, or as small as 150 px when it needs to fit Apple's 200 kB limit.largeshows a wide image. A square or portrait image is cropped to a 2:1 rectangle, and a landscape image keeps its shape.
square enlarges an image whose shorter side is under 240 px, and large one narrower than 240 px, which can blur it. Omit layout to keep the image's own shape, so Apple picks the layout from its shape and width.
Possible values: icon, square, large
rich_linkStored link preview. Includes its {{ variable }} placeholders.
interactiveStored interaction. Includes its {{ variable }} placeholders.
revisionThis language's revision counter, used for concurrent-edit checks on draft writes.
content_hashA fingerprint of Apple Messages template content, prefixed with its algorithm. Compare it within this API version to identify the exact source without transferring it.
updated_atWhen this language was last saved. Null for a built-in template.
Ressources associées
Poursuivez avec la documentation, les guides et les exemples sur ce sujet.