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.content);language = client.amb.templates.versions.languages.get(
"bird_order_update", "amv_01ky4x8e4genzb7way45txfkm1", "en"
)
print(language.language, language.content)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.Content)$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",
"content": {
"type": "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.
Parâmetros
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.
Payload de resposta
languageThe language in canonical BCP-47 form.
contentStored template content, including its {{ variable }} placeholders.
Mostrar atributos secundários
content.typeAlways text.
Value: text
content.bodyText displayed in the message. Use one U+FFFC object replacement character per attachment to control placement.
content.subjectSubject displayed above the message body.
content.attachmentsOrdered attachments. Each object supplies a source URL or an encrypted Apple reference.
content.typeAlways rich_link.
Value: rich_link
content.bodyAutomatic introductions for rich links are enabled regionally in stages. When enabled for a new send, a nonblank body is sent as a separate text before the link. All parts belong to one message, which becomes sent after Apple accepts all parts. Before activation, and for retries retaining legacy behavior, body is included in the rich link request and is not guaranteed to appear on the device. To ensure an introduction without relying on activation, send a separate text message and omit body from the rich link. Use one U+FFFC object replacement character per attachment to control placement.
content.subjectSubject displayed above the message body.
content.attachmentsOrdered attachments. Each object supplies a source URL or an encrypted Apple reference.
content.rich_link_datacontent.rich_link_data_refReusable Apple content reference. Supply the decryption key, or the signed bid and data_ref_sig returned by Apple.
content.rich_link_constructAsks Apple to build the rich link preview when the message is sent, rather than through a prior POST /v1/amb/messages/construct-payload call. No caller holds a signed reference until the send itself resolves one.
content.typeAlways interactive.
Value: interactive
content.bodyAutomatic introductions for inline quick replies are enabled regionally in stages. When enabled for a new send containing interactive_data.data.quick_reply, a nonblank body is sent as separate text before the choices. Messages using interactive_data_ref do not receive this automatic introduction, even after activation. All parts belong to one message, which becomes sent after Apple accepts all parts. For referenced interactions, before activation, and for retries retaining legacy behavior, body is included in the interactive request and is not guaranteed to appear on the device. To ensure an introduction without relying on activation, send a separate text message and omit body from the quick reply. Omit body to send choices only. For list pickers, time pickers and forms, use interactive_data.received_message for the visible introduction. Use one U+FFFC object replacement character per attachment to control placement.
content.subjectSubject displayed above the message body.
content.attachmentsOrdered attachments. Each object supplies a source URL or an encrypted Apple reference.
content.interactive_dataA built-in interaction or custom iMessage app. Custom apps require the app metadata and both message bubbles.
content.interactive_data_refReusable Apple content reference. Supply the decryption key, or the signed bid and data_ref_sig returned by Apple.
Mostrar atributos secundários
content.interactive_data_ref.titleTitle supplied by Apple for the preview.
content.interactive_data_ref.urlLocation of the encrypted preview.
content.interactive_data_ref.ownerOwner identifier supplied by Apple.
content.interactive_data_ref.signature_base64Signature supplied by Apple.
content.interactive_data_ref.keyDecryption key supplied by Apple.
content.interactive_data_ref.sizeSize of the encrypted preview in bytes.
content.interactive_data_ref.titleTitle supplied by Apple for the preview.
content.interactive_data_ref.bidMessages extension identifier supplied by Apple, when present.
content.interactive_data_ref.data_ref_sigSignature binding the reference to the business, when supplied by Apple.
content.interactive_data_ref.urlLocation of the encrypted preview.
content.interactive_data_ref.ownerOwner identifier supplied by Apple.
content.interactive_data_ref.signature_base64Signature supplied by Apple.
content.interactive_data_ref.sizeSize of the encrypted preview in bytes.
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.
Recursos relacionados
Continue com a documentação, guias e exemplos sobre este tópico.