Zum Hauptinhalt springen
X engagiert sich für unsere Community von Entwicklern, die mit der X API arbeiten. Im Rahmen dieses Engagements möchten wir unsere API für Entwickler offen und fair, für Menschen auf X sicher und für die X Plattform insgesamt vorteilhaft gestalten. Es ist entscheidend, dass jeder Entwickler, der X Inhalte offline speichert, sicherstellt, dass die data die Nutzerabsicht und den aktuellen Status der Inhalte auf X widerspiegelt. Wenn zum Beispiel jemand auf X einen Post oder sein Konto löscht, seine Posts schützt oder die Geo-Informationen aus seinen Posts entfernt, ist es sowohl für X als auch für unsere Entwickler wichtig, die Erwartungen und Absichten dieser Person zu respektieren. Die Batch-Compliance-endpoints bieten Entwicklern ein einfaches Werkzeug, um X data in Übereinstimmung mit der X Developer Agreement and Policy zu halten.  Diese Batch-Compliance-endpoints ermöglichen es Ihnen, große Datensätze von Post- oder Nutzer-IDs hochzuladen, um deren Compliance-Status abzurufen und so festzustellen, welche data Maßnahmen erfordert, damit Ihre Datensätze konform sind. Bitte beachten Sie, dass die Nutzung der Batch-Compliance-endpoints auf die oben genannten Anwendungsfälle beschränkt ist; jeder andere Zweck ist untersagt und kann zu Durchsetzungsmaßnahmen führen. In der Regel sind 4 Schritte bei der Arbeit mit diesem endpoint beteiligt:
  1. Erstellen Sie einen Compliance-Job Sie können den Jobtyp angeben (mit dem Wert tweets oder users, um anzugeben, ob der Datensatz, den Sie hochladen möchten, Post-IDs oder Nutzer-IDs enthält). Sie können jederzeit einen gleichzeitigen Job pro Jobtyp haben.
  2. Laden Sie Ihren Datensatz auf die upload_url hoch Als Nächstes laden Sie Ihren Datensatz als Nur-Text-Datei auf die bereitgestellte upload_url hoch, wobei jede Zeile der Datei eine einzelne Post-ID oder Nutzer-ID enthält. Die upload_url läuft nach 15 Minuten ab.
  3. (Optional) Überprüfen Sie den Jobstatus Sie können den Status Ihres Compliance-Jobs überprüfen, um festzustellen, ob er created, in_progress, failed oder complete ist.
  4. Laden Sie die Ergebnisse herunter Wenn Ihr Job abgeschlossen ist, können Sie die Ergebnisse mit der download_url herunterladen. Die download_url läuft eine Woche nach Erstellung des Jobs ab. Dieses Ergebnis enthält eine Reihe von JSON-Objekten (ein Objekt pro Zeile). Jedes Objekt enthält eine Post-ID, das Erstellungsdatum des Posts (nützlich, um Posts nach Datum zu finden), die erforderliche Aktion, den Grund für die Compliance-Maßnahme und das Datum, an dem der Nutzer suspendiert wurde.
Sie erhalten in Ihren Ergebnissen die folgenden Compliance-Ereignistypen:
  • deleted - zeigt an, dass der Post oder das Nutzerkonto gelöscht wurde
  • deactivated - zeigt an, dass der Post oder das Nutzerkonto deaktiviert wurde
  • scrub_geo - zeigt an, dass die mit dem Post oder dem Nutzer verknüpften Geo-Informationen entfernt wurden
  • protected - zeigt an, dass das Konto, das den Post erstellt hat, privat wurde
  • suspended - zeigt an, dass das Konto, das den Post erstellt hat, suspendiert wurde
Kontoeinrichtung Um auf diese endpoints zuzugreifen, benötigen Sie: Erfahren Sie mehr darüber, wie Sie Zugriff auf die X API v2 endpoints erhalten, in unserem Getting-started-Leitfaden.
⌘I