Alle handleidingen

YouTube koppelen aan Social Quack — de complete handleiding

YouTube werkt zoals TikTok: je maakt in de console van Google een kleine developer-app van jezelf aan, koppelt die in een paar minuten en kunt meteen uploaden — maar Google houdt die uploads privé tot het je project heeft beoordeeld. Deze pagina loopt beide helften door, met elk antwoord klaar om te plakken. Je doet dit maar één keer.

Sla je de review van Google liever over? Koppel dan via Zernio: één sleutel plakken, inloggen, uploaden — een paar minuten, openbare uploads vanaf dag één. Zie de Zernio-handleiding. Deze pagina is de doe-het-zelfroute, met je eigen Google Cloud-project.

Twee fases, en na fase 1 kun je al uploaden:

Fase Wat je krijgt Tijd
1. Maak de app aan Koppel je kanaal en upload — maar YouTube zet elke video op Private (privé) tot fase 2, en de koppeling moet elke 7 dagen worden vernieuwd ~10 min
2. Laat je beoordelen Uploads als Public en Unlisted, en een koppeling die blijft staan ~20 min van jouw tijd, daarna de review van Google

Shorts vragen niets bijzonders: een verticale video korter dan 3 minuten wordt vanzelf een Short.

Fase 1 — maak je Google Cloud-project aan en koppel

  1. Ga naar https://console.cloud.google.com en log in met het Google-account dat eigenaar is van je YouTube-kanaal (of een willekeurig Google-account — het kanaal kies je later).

  2. Maak een project aan: klik bovenaan op de projectkiezer → New project → geef het een naam (bijvoorbeeld My Social Quack) → Create, en zorg dat het daarna geselecteerd is.

  3. Zet de API aan: menu links APIs & Services → Library → zoek YouTube Data API v3 → Enable.

  4. Stel het toestemmingsscherm in: menu links APIs & Services → Google Auth Platform (oudere projecten tonen OAuth consent screen) → Get started:

    • App information: een app-naam (bijvoorbeeld My Social Quack), user support email = je eigen adres.
    • Audience: External.
    • Contact information: nogmaals je adres → akkoord gaan → Create.

  5. Voeg jezelf toe als testgebruiker: Google Auth Platform → Audience → Test users → Add users → je Google-adres → Save. (Zolang de app op Testing staat, kunnen alleen testgebruikers koppelen.)

  6. Voeg de scopes toe: Google Auth Platform → Data Access → Add or remove scopes → filter op youtube en vink aan:

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

    → Update → Save. Beide zijn „gevoelige" scopes; dat maakt pas uit in fase 2.

  7. Maak de inloggegevens aan: Google Auth Platform → Clients → Create client → Application type Desktop app → geef het een naam → Create. Kopieer de Client ID en het Client secret (je kunt ze ook als JSON downloaden).

    Waarom Desktop app? Social Quack draait op je eigen computer, en het clienttype Desktop van Google accepteert het localhost-adres waar Social Quack op luistert, zonder dat je een website hoeft te registreren. Bij dit clienttype hoef je geen redirect-adres toe te voegen. Toont Google ooit redirect_uri_mismatch, dan is de client aangemaakt als Web application — maak in plaats daarvan een Desktop-client aan.

  8. In Social Quack: Channels → YouTube → Set up keys ▾ → Set up app keys (sleutels instellen → app-sleutels instellen) → plak de Client ID en het secret → Connect (koppelen). Je browser opent de inlogpagina van Google: kies het account, kies het kanaal als daarom gevraagd wordt, en klik op het scherm „Google hasn't verified this app" op Continue (jij bent de developer — in fase 1 hoort dit zo). Vink beide toestemmingen aan → Continue. Je kanaal verschijnt onder Connected (gekoppeld).

  9. Upload een testvideo vanuit Compose (opstellen): voeg de video toe, vink het YouTube-kanaal aan en vul het paneel YouTube options (YouTube-opties) in dat verschijnt — titel, zichtbaarheid, de verklaring made for kids, tags. Post meteen of plan hem in. Open YouTube Studio: de video staat er — als Private, welke zichtbaarheid je ook koos. Dat is de regel van Google voor projecten die nog niet zijn beoordeeld (zie fase 2), geen fout in Social Quack.

Twee dingen om te weten zolang je in fase 1 zit:

  • Koppel elke 7 dagen opnieuw. Google laat de koppeling van elke app in Testing na 7 dagen verlopen. Social Quack meldt het je op de pagina Channels wanneer dat gebeurt; klik dan weer op Connect. Fase 2 maakt hier een eind aan.
  • Quotum: een nieuw project mag 100 video's per dag uploaden en 10.000 eenheden aan andere aanroepen doen (een thumbnail kost er 50). Ruim genoeg voor één persoon of een klein team; bureaus kunnen in fase 2 om meer vragen.

Fase 2 — laat je beoordelen (openbare uploads, blijvende koppeling)

Er zijn twee aparte reviews, door twee verschillende teams bij Google. Doe ze allebei; elk is een formulier.

A. Compliance-audit van de YouTube API — heft de regel „alleen privé" op

Bij elk project dat na 28 juli 2020 is aangemaakt, staan de uploads vast op Private tot YouTube het heeft gecontroleerd op naleving van de YouTube API Services Terms of Service.

  1. Open het YouTube API Services – Audit and Quota Extension Form: https://support.google.com/youtube/contact/yt_api_form
  2. Vul het in met de kant-en-klare antwoorden hieronder. Waar gevraagd wordt naar de API-client, zeg je dat het een persoonlijke desktopplanner is die alleen voor je eigen kanaal wordt gebruikt; waar om een demo gevraagd wordt, voeg je de schermopname toe.
  3. Wil je meer dan 100 uploads per dag, vraag dan in hetzelfde formulier om een hoger quotum en zeg hoeveel.

Je krijgt een e-mail zodra de audit is goedgekeurd. Vanaf dan gebruikt YouTube de zichtbaarheid die je in Social Quack kiest (Public / Unlisted / Private).

B. Verificatie van de OAuth-app — geen koppeling meer om de 7 dagen, geen waarschuwingsscherm

  1. Google Auth Platform → Audience → Publish app → bevestigen. Je app staat nu op In production. Vanaf nu verlopen koppelingen niet meer na 7 dagen. Tot de verificatie klaar is, toont de inlogpagina nog steeds „Google hasn't verified this app" — klik op Advanced → Go to (your app name) om door te gaan; Google laat maximaal 100 mensen dat doen per niet-geverifieerde app, veel meer dan één kanaal nodig heeft.
  2. Google Auth Platform → Branding: voeg je app-logo toe (optioneel), en zet onder Authorized domains socialquack.com; Application home page https://socialquack.com, Privacy policy https://socialquack.com/privacy, Terms of service https://socialquack.com/terms. Opslaan.
  3. Google Auth Platform → Verification Center → Prepare for verification → controleer de gegevens → plak bij elke scope de onderbouwing uit de kant-en-klare antwoorden → voeg de link naar je demovideo toe (upload hem als Unlisted op YouTube, of op Drive) → Submit for verification.
  4. Google mailt je vragen en de uitkomst. Een kleine persoonlijke app wordt meestal goedgekeurd, zolang de video het toestemmingsscherm laat zien en elke toestemming in gebruik.

Je kunt B helemaal overslaan en leven met het waarschuwingsscherm en de klik op Advanced → Go to app — dat is een persoonlijke keuze. A kun je niet overslaan als je openbaar wilt uploaden.

Kant-en-klare antwoorden

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.

De demovideo — wat je opneemt

Een schermopname van 60–90 seconden, in één keer, zonder voice-over. Mac: ⌘⇧5 of QuickTime → New Screen Recording.

  1. (0:00) Open Social Quack en laat de pagina Channels (kanalen) zien.
  2. (0:05) Klik op Connect bij YouTube. De inlogpagina van Google opent in de browser — laat het toestemmingsscherm met beide toestemmingen zien en klik op Continue. Laat Social Quack zien, met het kanaal nu onder Connected.
  3. (0:25) Compose: voeg een korte video toe, vink het YouTube-kanaal aan, vul het paneel YouTube options in (titel, zichtbaarheid, made for kids) en klik op Post now.
  4. (0:45) Laat zien hoe de post in de Queue (wachtrij) op published springt en klik op de link.
  5. (1:00) Laat de video zien in YouTube Studio, op je kanaal.
  6. (1:15, optioneel) Channels → Remove (verwijderen) bij het YouTube-kanaal, om te laten zien dat ontkoppelen de toegang intrekt.

Als er iets misgaat

Wat je ziet Wat het betekent Doe dit
access_denied / „app is currently being tested" op de inlogpagina van Google Je Google-account is geen testgebruiker, of je bent met een ander account ingelogd Google Auth Platform → Audience → Test users → voeg precies dat adres toe en klik daarna opnieuw op Connect
redirect_uri_mismatch De OAuth-client is een Web application Maak een nieuwe client aan van het type Desktop app en plak de ID en het secret daarvan
„Google hasn't verified this app" Normaal vóór de verificatie Continue (testgebruiker) of Advanced → Go to app (gepubliceerde app)
De koppeling stopt na een week (invalid_grant) De app staat op Testing Koppel opnieuw; of publiceer de app (fase 2 B, stap 1) om dit te stoppen
De video wordt geüpload maar staat op Private, terwijl je Public koos Het project is nog niet geaudit Fase 2 A — de compliance-audit
quotaExceeded 100 uploads vandaag, of 10.000 eenheden aan andere aanroepen Wacht tot middernacht Pacific-tijd, of vraag meer aan in het auditformulier
De thumbnail is niet toegepast Het YouTube-account is niet geverifieerd met een telefoonnummer youtube.com/verify — de volgende upload zet hem dan wel
forbidden bij het uploaden met een Brand Account Je hebt bij het inloggen het verkeerde kanaal gekozen Channels → Remove → opnieuw Connect en kies het juiste kanaal

Loop je vast bij een stap? Mail [email protected] en je krijgt antwoord van een mens.