Collegare YouTube a Social Quack — la guida completa

YouTube funziona come TikTok: crei una piccola app per sviluppatori tua nella console di Google, la colleghi in pochi minuti e puoi caricare subito — ma Google tiene quei caricamenti privati finché non ha revisionato il tuo progetto. Questa pagina ti guida in entrambe le metà, con ogni risposta pronta da incollare. Lo fai una volta sola.

Preferisci saltare la revisione di Google? Collegati tramite Zernio: incolli una chiave, accedi, carichi — pochi minuti, caricamenti pubblici dal primo giorno. Vedi la guida a Zernio. Questa pagina è la strada fai-da-te, con un tuo progetto Google Cloud.

Due fasi, e puoi iniziare a caricare già dopo la fase 1:

Gli Shorts non richiedono niente di speciale: un video verticale sotto i 3 minuti diventa uno Short in automatico.

Fase 1 — crea il tuo progetto Google Cloud e collegati

1. Vai su https://console.cloud.google.com e accedi con l'account Google proprietario del tuo canale YouTube (o con un account Google qualsiasi — il canale lo scegli dopo).

2. Crea un progetto: clicca il selettore dei progetti in alto → New project → dagli un nome (per esempio My Social Quack) → Create, poi controlla che sia selezionato.

3. Attiva l'API: menu a sinistra APIs & Services → Library → cerca YouTube Data API v3 → Enable.

4. Configura la schermata di consenso: menu a sinistra APIs & Services → Google Auth Platform (nei progetti più vecchi si chiama OAuth consent screen) → Get started:

   • App information: nome dell'app (per esempio My Social Quack), email di assistenza utenti = il tuo indirizzo.
   • Audience: External.
   • Contact information: di nuovo il tuo indirizzo → accetta → Create.

5. Aggiungiti come utente di test: Google Auth Platform → Audience → Test users → Add users → il tuo indirizzo Google → Save. (Finché l'app è in Testing, possono collegarsi solo gli utenti di test.)

6. Aggiungi gli scope: Google Auth Platform → Data Access → Add or remove scopes → filtra per youtube e spunta:

   • https://www.googleapis.com/auth/youtube.upload
   • https://www.googleapis.com/auth/youtube.readonly

   → Update → Save. Sono entrambi scope "sensibili"; conta solo per la fase 2.

7. Crea le credenziali: Google Auth Platform → Clients → Create client → Application type Desktop app → dagli un nome → Create. Copia il Client ID e il Client secret (puoi anche scaricarli come JSON).

   Perché Desktop app? Social Quack gira sul tuo computer, e il tipo di client Desktop di Google accetta l'indirizzo localhost su cui Social Quack è in ascolto senza registrare un sito web. Per questo tipo di client non c'è nessun URI di reindirizzamento da aggiungere. Se Google mostra redirect_uri_mismatch, il client è stato creato come Web application — creane uno Desktop.

8. In Social Quack: Channels → YouTube → Set up keys ▾ → Set up app keys (configura le chiavi → configura le chiavi dell'app) → incolla Client ID e secret → Connect (collega). Il browser apre l'accesso di Google: scegli l'account, scegli il canale se te lo chiede e, sulla schermata "Google hasn't verified this app", clicca Continue (lo sviluppatore sei tu — nella fase 1 è normale). Spunta entrambe le autorizzazioni → Continue. Il tuo canale compare sotto Connected (collegati).

9. Carica un video di prova da Compose (Componi): allega il video, spunta il canale YouTube e compila il pannello YouTube options (opzioni YouTube) che compare — titolo, visibilità, la dichiarazione made for kids, tag. Pubblica subito o programmalo. Apri YouTube Studio: il video c'è — come Private, qualunque visibilità tu abbia scelto. È la regola di Google per i progetti non revisionati (vedi la fase 2), non un bug di Social Quack.

Due cose da sapere mentre sei nella fase 1:

• Ricollegati ogni 7 giorni. Google fa scadere dopo 7 giorni il collegamento di qualsiasi app in Testing. Quando succede Social Quack te lo dice in Channels; clicca di nuovo Connect. La fase 2 risolve il problema.
• Quota: un progetto nuovo può caricare 100 video al giorno e fare 10.000 unità di altre chiamate (una miniatura ne costa 50). Più che sufficienti per una persona o un piccolo team; le agenzie possono chiederne di più nella fase 2.

Fase 2 — fatti revisionare (caricamenti pubblici, collegamento permanente)

Ci sono due revisioni distinte, di due team Google diversi. Falle entrambe; ognuna è un modulo.

A. Audit di conformità dell'API di YouTube — toglie la regola "solo privato"

Ogni progetto creato dopo il 28 luglio 2020 ha i caricamenti bloccati su Private finché YouTube non ha verificato che rispetti i Termini di servizio dei YouTube API Services.

1. Apri il modulo YouTube API Services – Audit and Quota Extension Form: https://support.google.com/youtube/contact/yt_api_form
2. Compilalo con le risposte da copiare e incollare qui sotto. Dove chiede del client API, scrivi che è uno strumento desktop di pianificazione personale usato solo per il tuo canale; dove chiede una demo, allega la registrazione dello schermo.
3. Se vuoi più di 100 caricamenti al giorno, chiedi l'aumento di quota nello stesso modulo e indica quanti.

Quando l'audit è superato ricevi un'email. Da lì in poi YouTube usa la visibilità che scegli in Social Quack (Public / Unlisted / Private).

B. Verifica dell'app OAuth — niente più ricollegamenti ogni 7 giorni né schermata di avviso

1. Google Auth Platform → Audience → Publish app → conferma. La tua app ora è In production. Da qui in poi i collegamenti non scadono più dopo 7 giorni. Finché la verifica non è finita, l'accesso mostra ancora "Google hasn't verified this app" — clicca Advanced → Go to (il nome della tua app) per proseguire; Google permette di farlo a un massimo di 100 persone per app non verificata, molte più di quante ne servano per un canale.
2. Google Auth Platform → Branding: aggiungi il logo della tua app (facoltativo) e sotto Authorized domains aggiungi socialquack.com; Application home page https://socialquack.com, Privacy policy https://socialquack.com/privacy, Terms of service https://socialquack.com/terms. Salva.
3. Google Auth Platform → Verification Center → Prepare for verification → controlla i dati → per ogni scope incolla la motivazione dalle risposte da copiare e incollare → aggiungi il link al tuo video dimostrativo (caricalo su YouTube come Unlisted, oppure su Drive) → Submit for verification.
4. Google ti manda domande ed esito via email. La verifica di una piccola app personale di solito viene approvata, purché il video mostri la schermata di consenso e ogni autorizzazione in uso.

Puoi saltare del tutto la B e convivere con la schermata di avviso e il clic su Advanced → Go to app — è una scelta personale. Non puoi saltare la A se vuoi caricamenti pubblici.

Risposte da copiare e incollare

What does your application do?

Personal social-media scheduling tool. I write and schedule posts on my own computer (Social Quack, a self-hosted scheduler that runs locally on my Mac/PC) and it uploads them to my own YouTube channel at the scheduled time. Single user: me. The application never accesses other users' data, does not read comments or analytics, and stores nothing on any server — access tokens are kept encrypted on my computer only and deleted when I disconnect the channel.

How is each scope used?

youtube.upload — uploads the video file for a post I created and scheduled myself, with the title, description, tags and visibility I chose, and sets the thumbnail I attached.

youtube.readonly — reads my own channel's name and avatar once, to show which channel is connected in the app.

API client / platform → Desktop application installed on the user's own computer; website https://socialquack.com.

Expected number of users → 1 (my own account). Quota → the default is enough (or state the number of uploads per day you need).

Do you display or store YouTube data? → No. The app only uploads; it shows the channel name in its own settings page and stores nothing about other users.

Il video dimostrativo — cosa registrare

Una registrazione dello schermo di 60–90 secondi, in una sola ripresa, senza bisogno di voce fuori campo. Mac: ⌘⇧5 oppure QuickTime → New Screen Recording.

1. (0:00) Apri Social Quack e mostra la pagina Channels (Canali).
2. (0:05) Clicca Connect su YouTube. L'accesso di Google si apre nel browser — mostra la schermata di consenso con entrambe le autorizzazioni e clicca Continue. Mostra Social Quack con il canale ora sotto Connected.
3. (0:25) Compose: allega un video breve, spunta il canale YouTube, compila il pannello YouTube options (titolo, visibilità, made-for-kids) e clicca Post now.
4. (0:45) Mostra il post che diventa published nella Queue (Coda) e clicca il suo link.
5. (1:00) Mostra il video in YouTube Studio, sul tuo canale.
6. (1:15, facoltativo) Channels → Remove (rimuovi) il canale YouTube, per mostrare che scollegarlo revoca l'accesso.

Se qualcosa non funziona