Vai al contenuto principale
X è impegnata nei confronti della nostra community di sviluppatori che creano con la X API. Come parte di questo impegno, puntiamo a rendere la nostra API aperta ed equa per gli sviluppatori, sicura per le persone su X e vantaggiosa per l’intera piattaforma X. È fondamentale che qualsiasi sviluppatore che archivia contenuti di X offline garantisca che i data riflettano l’intento dell’utente e lo stato attuale dei contenuti su X. Ad esempio, quando qualcuno su X elimina un Post o il proprio account, protegge i propri Post o rimuove le informazioni geografiche dai propri Post, è fondamentale sia per X sia per i nostri sviluppatori rispettare le aspettative e l’intento di quella persona. Gli endpoint di compliance batch forniscono agli sviluppatori uno strumento semplice per mantenere i data di X conformi all’X Developer Agreement and Policy.  Questi endpoint di compliance batch consentono di caricare grandi dataset di ID di Post o di utenti per recuperare il relativo stato di conformità, così da determinare quali data richiedono un’azione per rendere i propri dataset conformi. Si noti che l’uso degli endpoint di compliance batch è limitato ai casi d’uso sopra menzionati; qualsiasi altro scopo è vietato e può comportare azioni di enforcement. In genere, lavorare con questo endpoint prevede 4 passaggi:
  1. Create a compliance job È possibile specificare il tipo di job (con il valore tweets o users) per indicare se il dataset che si desidera caricare contiene ID del Post o ID utente. È possibile avere un job contemporaneo per tipo di job in qualsiasi momento.
  2. Upload your dataset to the upload_url Successivamente, si carica il dataset come file di testo semplice nell’upload_url fornito, con ogni riga del file contenente un singolo ID del Post o ID utente. L’upload_url scade dopo 15 minuti.
  3. (Optional) Check the job status È possibile verificare lo stato del job di compliance per vedere se è created, in_progress, failed o complete.
  4. Download the results Quando il job è complete, è possibile scaricare i risultati utilizzando il download_url. Il download_url scade dopo una settimana (a partire dalla creazione del job). Il risultato conterrà un insieme di oggetti JSON (un oggetto per riga). Ogni oggetto conterrà un ID del Post, la data di creazione del Post (utile per individuare i Post organizzati per data), l’azione richiesta, il motivo dell’azione di conformità e la data in cui l’utente è stato sospeso.
Si riceveranno i seguenti tipi di eventi di conformità nei risultati:
  • deleted - indica che il Post o l’account utente è stato eliminato
  • deactivated - indica che il Post o l’account utente è stato disattivato
  • scrub_geo - indica che le informazioni geografiche associate al Post o all’utente sono state rimosse
  • protected - indica che l’account che ha pubblicato il Post è diventato privato
  • suspended - indica che l’account che ha pubblicato il Post è stato sospeso
Configurazione dell’account Per accedere a questi endpoint, è necessario: Scopri di più su come ottenere l’accesso agli endpoint di X API v2 nella nostra guida introduttiva.
⌘I