Integration mit den Timelines-endpoints
- Nützliche Tools
- Schlüsselkonzepte
Nützliche Tools
Zentrale Konzepte
Bitte beachtenWenn Sie die folgenden fields anfordern, ist OAuth 1.0a User Context oder OAuth 2.0 Authorization Code erforderlich:
tweet.fields.non_public_metricstweet.fields.promoted_metricstweet.fields.organic_metricsmedia.fields.non_public_metricsmedia.fields.promoted_metricsmedia.fields.organic_metrics
tweet.fields.non_public_metricstweet.fields.promoted_metricstweet.fields.organic_metricsmedia.fields.non_public_metricsmedia.fields.promoted_metricsmedia.fields.organic_metrics
non_public_metrics für die Nutzer-Post-Timeline der Nutzer-ID 1234 zu erhalten, müssen Sie access tokens einbeziehen, die diesem Nutzer zugeordnet sind. Sie können Nutzer Ihre App autorisieren lassen und mit dem 3-legged OAuth-Flow einen Satz von access tokens erhalten, die ihnen zugeordnet sind.
Wenn Sie die Nutzer-Mention-Timeline verwenden, sind die genannten Felder nur verfügbar, wenn der erwähnende Autor Ihrer App den Zugriff auf seine privaten metrics-data autorisiert hat und Sie beim Stellen der Anfrage mit OAuth 1.0a User Context die access tokens dieses Nutzers verwenden.
Alle non_public_metrics, organic_metrics und promoted_metrics sind nur für Posts verfügbar, die in den letzten 30 Tagen erstellt wurden. Das bedeutet, dass sich die Ergebnisse beim Anfordern der genannten Felder automatisch so anpassen, dass nur Posts aus den letzten 30 Tagen enthalten sind.
Wenn diese genannten Felder angefordert werden, werden nur Posts zurückgegeben, die vom authentifizierten Nutzer verfasst wurden; alle anderen Posts erhalten eine Fehlermeldung.
Pagination
Diese endpoints verwenden Pagination, damit Antworten schnell zurückgegeben werden. In Fällen, in denen es mehr Ergebnisse gibt, als in einer einzelnen Antwort gesendet werden können (bis zu 100 Posts für die Timeline-endpoints), müssen Sie paginieren. Verwenden Sie den Parameter max_results, um anzugeben, wie viele Ergebnisse pro Seite zurückgegeben werden, und den Parameter pagination_token, um die nächste Ergebnisseite zurückzugeben. Mehr dazu erfahren Sie in unserem Pagination-Leitfaden.
Filtering results
Diese endpoints enthalten mehrere Parameter, mit denen Sie Ergebnisse filtern können. Mit start_date und end_date können Sie Ergebnisse auf einen bestimmten Zeitraum eingrenzen. Wenn Sie lieber Post-IDs verwenden möchten, um eine bestimmte Menge von Posts auszuwählen, können Sie since_id und until_id verwenden. Die Benutzer-Posts-Timeline verfügt außerdem über einen exclude-Parameter, mit dem Retweets und Antworten aus Ihren Ergebnissen entfernt werden können.
Post caps und Anzahl der zurückgegebenen Posts
Die endpoints der Benutzer-Post-Timeline und der Benutzer-Erwähnungs-Timeline sind in der Anzahl der Posts begrenzt, die sie in einem bestimmten Monat zurückgeben können. Das endpoint der umgekehrt chronologischen Home-Timeline unterliegt dieser Einschränkung nicht.
Unabhängig davon, welches Timelines-endpoint Sie verwenden, werden die zurückgegebenen Posts auf die projektweite Post caps angerechnet. Die Nutzung wird im Entwicklerportal angezeigt, und der „Monat“ beginnt an Ihrem Verlängerungstag des Abonnements, der auf dem developer portal dashboard angezeigt wird.
Das endpoint der Benutzer-Post-Timeline gibt nur die neuesten 3200 Posts zurück, die in der Timeline eines Benutzers veröffentlicht wurden. Wenn Sie start_time und end_time auf einen Zeitraum setzen, der Posts außerhalb der 3200 neuesten umfasst, erhalten Sie zwar eine erfolgreiche Antwort, aber keine Posts.
Es ist auch wichtig zu beachten, dass, wenn Sie excludes=replies bei Ihren Anfragen an die Benutzer-Post-Timeline übergeben, nur die neuesten 800 Posts zurückgegeben werden.
Das endpoint der Benutzer-Erwähnungs-Timeline gibt nur die neuesten 800 Post-Erwähnungen zurück.
Das endpoint der umgekehrt chronologischen Home-Timeline gibt die letzten 3200 Posts zurück.
Post-Bearbeitungen
Posts, die für Bearbeitungen berechtigt sind, können bis zu fünfmal innerhalb von 30 Minuten nach Veröffentlichung des ursprünglichen Posts bearbeitet werden. Die Such-endpoints liefern stets die neueste Version des Posts. Wenn Sie nur Posts anfordern, die vor 30 oder mehr Minuten veröffentlicht wurden, erhalten Sie immer die endgültige Version des Posts. Wenn Sie jedoch einen Near-Real-Time-Anwendungsfall haben und Posts abfragen, die in den letzten dreißig Minuten veröffentlicht wurden, könnten diese Posts nach dem Empfang bearbeitet worden sein. Diese Posts können mit der Suche oder dem Post Lookup-endpoint erneut hydriert werden, um ihren endgültigen Status zu bestätigen. Weitere Informationen darüber, wie Post-Bearbeitungen funktionieren, finden Sie auf der Seite Edit Posts fundamentals.
Randfälle
- Wenn Sie nicht öffentliche metrics im endpoint der Benutzer-Post-Timeline für Posts anfordern, die älter als 30 Tage sind, kann es sein, dass Sie ein next_token in der Antwort mit einer Ergebnisanzahl von 0 sehen. Um dieses Problem zu vermeiden, stellen Sie sicher, dass der mit dem Parameter non_public_metrics angeforderte Zeitraum innerhalb der letzten 30 Tage liegt. Zusätzlich sollte der Mindestwert von max_results 10 sein. Diese Maßnahmen können helfen, dieses Szenario zu vermeiden, es kann jedoch trotzdem auftreten.
- Das Anfordern von promoted metrics für Posts, die nicht beworben wurden, liefert eine leere Antwort, anstatt Post-data. Unser Team arbeitet derzeit an der Behebung dieses Problems.
- Bei einem Retweet, der Post-Text mit mehr als 140 Zeichen enthält, wird das text-Feld abgeschnitten, anstatt den vollständigen Post-Text zurückzugeben. Der kurzfristige Workaround besteht darin, den referenzierten Post zu expandieren und den vollständigen Text aus der Expansion abzurufen. Dies ist ein Bug, den wir in Zukunft beheben werden.