Einführung

Ein Medienobjekt steht für ein einzelnes Foto, Video oder animiertes GIF. Medienobjekte werden von vielen endpoint innerhalb der X API verwendet und können in Posts, Direct Messages, Benutzerprofilen, Werbemitteln und an anderen Stellen vorkommen. Jedes Medienobjekt kann mehrere Anzeige- oder Wiedergabevarianten mit unterschiedlichen Auflösungen oder Formaten aufweisen.

​

Medientypen und Größenbeschränkungen

Größenbeschränkungen für das Hochladen über die API

• Bild: 5 MB
• GIF: 15 MB
• Video: 512 MB (bei Verwendung von media_category=amplify_video)

​

Erstellung

Objekte wie Posts, Direct Messages, Benutzerprofilbilder, gehostete Ads-Cards usw. können ein oder mehrere Medienobjekte enthalten. Diese Objekte auf oberster Ebene werden zusammenfassend als Entitäten bezeichnet. Die relevante API zur Erstellung von Entitäten (z. B. POST /2/tweets) kann ein oder mehrere Medienobjekte mithilfe einer eindeutigen media_id entgegennehmen.

Eine Entität, die Medienobjekte enthält, kann durch folgende Schritte erstellt werden:

1. Laden Sie die Mediendatei(en) entweder mit dem empfohlenen chunked-Upload (Bilder/GIF/Video) oder dem älteren simple-Upload (nur Bilder) hoch.
2. Empfangen Sie eine media_id aus Schritt 1. Dieser Schritt kann mehrfach mit unterschiedlichen Medien wiederholt werden, wenn die Entität mehrere media_id-Parameter zulässt.
3. Erstellen Sie die Entität, indem Sie den entsprechenden endpoint aufrufen und die media_id sowie andere erforderliche Parameter angeben. Hängen Sie beispielsweise eine media_id an einen Post an, indem Sie den POST /2/tweets-endpoint verwenden.

​

Abrufen

Bitte beachten Sie das Media Object im Data Dictionary.