Publit.Si
Dokumentation›YouTube verbinden

Plattformen

YouTube verbinden

Du erstellst dein eigenes Google-Projekt; eine Einladung von Publit.Si ist nicht nötig. Starte im Testmodus: Das funktioniert in wenigen Minuten ohne Domain; du verbindest alle sieben Tage neu. Mit einem Cloudflare-Tunnel kannst du später zu Produktion wechseln und die wöchentliche Neuanmeldung vermeiden.

Das brauchst du

  • Ein Google-Konto, dem dein YouTube-Kanal gehört (oder das das Brand-Konto verwaltet)
  • Sonst nichts im Testmodus. Für Produktion: ein Cloudflare-Tunnel

Projekt erstellen und APIs aktivieren

  1. Öffne console.cloud.google.com → Projektauswahl oben → New project. Der Name ist frei wählbar, etwa „Publit.Si“.

  2. APIs & Services → Library → YouTube Data API v3 suchen → Enable (aktivieren).

    Google Cloud, YouTube Data API v3 ist bereits aktiviert: Schaltfläche Manage und Anzeige API Enabled
    1. 1:Enable / Manage (aktivieren / verwalten)
    YouTube Data API v3 → Enable. Nach Aktivierung heißt die Schaltfläche Manage; „API Enabled“ erscheint.
  3. Aktiviere ebenso YouTube Analytics API, wenn du Wiedergabezeit sehen möchtest. Ohne sie funktioniert alles andere weiter.

  4. Du hast einen Blog? Aktiviere auch Google Search Console API für Suchstatistiken. Der Rest steht in der Blog-Anleitung.

App benennen

  1. Öffne Google Auth Platform (ältere Menüs: APIs & Services → OAuth consent screen). Klicke bei Bedarf auf Get started (loslegen).

  2. Branding: App-Name (etwa „Publit.Si“), deine User support email und unter Developer contact information deine E-Mail-Adresse → Save. Ein Logo ist optional.

    Google Auth Platform, Branding › App information mit App-Name und Support-E-Mail
    1. 1:Branding
    2. 2:App name (App-Name)
    3. 3:User support email (Support-E-Mail)
    Branding → App information: App-Name und Support-E-Mail. Der Entwicklerkontakt steht weiter unten.
  3. Audience (Zielgruppe): Nutzertyp External (extern).

Dich als Testnutzer hinzufügen

Dieser Schritt wird oft übersehen. Ohne ihn zeigt Google „Access blocked“ mit „Error 403: access_denied“.

  1. Audience → Test users → + Add users (Nutzer hinzufügen).

    Google Auth Platform, Audience mit Status Testing, Nutzertyp External, Nutzergrenze und Test users samt Add users
    1. 1:Testing (Testmodus)
    2. 2:External (extern)
    3. 3:Add users (Nutzer hinzufügen)
    Audience → Test users → + Add users. Dieser Schritt behebt „Access blocked“.
  2. Trage das Google-Konto ein, dem dein YouTube-Kanal gehört. Bei einem Brand-Konto: das verwaltende Google-Konto. → Save.

    Add users mit eingegebener Google-Konto-E-Mail und Schaltfläche Save
    1. 1:Dein Google-Konto
    2. 2:Save (speichern)
    Füge das Google-Konto hinzu, dem dein YouTube-Kanal gehört, danach Save.

OAuth-Client erstellen

  1. Öffne in Publit.Si Settings › Platform setup › YouTube und kopiere die Weiterleitungsadresse, üblicherweise http://localhost:3000/api/oauth/youtube/callback.

    Publit.Si, Settings › Platform setup: Je Plattform eine Karte mit Prüfungen, Status und kopierbarer Weiterleitungsadresse
    1. 1:Plattformstatus
    2. 2:Weiterleitungsadresse kopieren
    Settings › Platform setup zeigt eingerichtete Werte je Plattform und die genaue Weiterleitungsadresse zum Kopieren.
  2. Google: Clients → Create client → Anwendungstyp Web application (Webanwendung). Der Name dient nur dir.

    Create OAuth client ID mit Anwendungstyp Web application und Name
    1. 1:Clients
    2. 2:Web application (Webanwendung)
    Clients → Create client → Anwendungstyp Web application. Der Name dient nur dir.
  3. Authorized redirect URIs → + Add URI → einfügen → Create. Lasse Authorized JavaScript origins leer.

    OAuth-Webanwendungsclient mit leeren Authorized JavaScript origins und localhost-Callback unter Authorized redirect URIs
    1. 1:JavaScript origins: leer lassen
    2. 2:Authorized redirect URIs (Weiterleitungsadressen)
    Der Callback gehört unter Authorized redirect URIs, nicht unter JavaScript origins.
  4. Google zeigt Client ID und Client secret. Trage beide in Publit.Si unter Enter credentials oder in .env ein:

    GOOGLE_CLIENT_ID=…
    GOOGLE_CLIENT_SECRET=…
    Publit.Si-Formular Enter credentials mit eingetragener Google-Client-ID und leerem Secret-Feld
    1. 1:Client ID (Client-ID)
    2. 2:Save and apply (speichern und anwenden)
    Enter credentials trägt Schlüssel in .env ein und startet die Dienste neu. Zugangsdaten werden nie erneut angezeigt.

Kanal verbinden

  1. Publit.Si → Accounts → Connect account → YouTube.

    Accounts-Seite mit geöffnetem Menü Connect account für Instagram, YouTube und TikTok
    1. 1:Connect account (Konto verbinden)
    2. 2:YouTube
    Accounts › Connect account: Plattform auswählen.
  2. Publit.Si fragt nach dem Anmeldefenster: Wähle ein Chrome-Profil oder In this window (in diesem Fenster).

  3. Wähle das als Testnutzer eingetragene Google-Konto. Google warnt „Google hasn't verified this app … currently being tested“: Klicke auf Continue (weiter). Es ist deine eigene App.

    Google-Anmeldewarnung: Google hasn't verified this app; Zugriff auf eine getestete App, mit Continue und Back to safety
    1. 1:Continue (weiter)
    Im Testmodus meldet Google Zugriff auf eine App im Test. Es ist deine eigene App: Klicke auf Continue (weiter).
  4. Google zeigt die Zugriffsrechte mit drei noch nicht gewählten YouTube-Kästchen. Wähle Select all → Continue. Ohne Upload-Berechtigung kann Publit.Si nicht veröffentlichen und meldet „Upload permission was not granted“. Der Hinweis auf eine fehlende Verknüpfung zur Datenschutzerklärung ist im Testmodus normal.

  5. Mehrere Kanäle? Google fragt nach dem gewünschten Kanal. Dein eigener Kanal erscheint unter deinem Namen, nicht unter dem Kanalnamen.

Tunnel erforderlich

Optional: Ohne wöchentliche Neuanmeldung

Stelle das Projekt einmal auf Produktion um; dann entfällt die Sieben-Tage-Grenze. Google erlaubt das nur, wenn Branding eine Startseite, Datenschutz- und Nutzungsbedingungen auf deiner Domain enthält. Dein Gateway stellt alle drei bereit.

  1. Prüfe, dass PUBLITSI_OPERATOR_NAME und PUBLITSI_OPERATOR_EMAIL in .env gesetzt sind (siehe Cloudflare-Tunnel). Öffne zur Kontrolle https://publish.example.com/privacy.

  2. Publit.Si → Settings › Platform setup › YouTube › Keep YouTube connected zeigt deine genauen Werte.

    Publit.Si, Platform setup › YouTube: Keep YouTube connected mit Testmodus sowie Startseiten-, Datenschutz-, AGB- und Domainwerten für Google Branding
    1. 1:Testmodus: Dich als Testnutzer hinzufügen
    2. 2:Produktion: Werte für Branding
    Keep YouTube connected zeigt die genauen Werte für Googles Branding-Seite, aus deiner Tunnel-Adresse vorausgefüllt.
  3. Branding → App domain: Application home page https://publish.example.com/, Application privacy policy link https://publish.example.com/privacy, Application terms of service link https://publish.example.com/terms. Authorized domains → + Add domain → example.com (ohne https://, niemals localhost) → Save.

    Branding › App domain mit leeren Feldern für Startseite, Datenschutz und Nutzungsbedingungen sowie Authorized domains mit Add domain
    1. 1:Startseite, Datenschutz, Nutzungsbedingungen
    2. 2:Add domain (Domain hinzufügen)
    Nur für Produktion: App domain enthält die drei Gateway-Links, Authorized domains deine Domain.
  4. Falls Google eine Domainbestätigung verlangt, erledige sie in Google Search Console mit demselben Google-Konto.

  5. Audience → Publish app (bis zum vollständigen Branding ausgegraut) → Confirm. Der Status wird In production. Für die eigene Nutzung mit weniger als 100 Nutzern verlangt Google keine Prüfung.

    Audience, Status Testing mit ausgegrautem Publish app und Hinweis auf unvollständiges Branding
    1. 1:Testing (Testmodus)
    2. 2:Publish app (App veröffentlichen)
    Publish app bleibt bis zum vollständigen Branding ausgegraut. Danach anklicken → In production → YouTube einmal neu verbinden.
  6. Publit.Si → Accounts → YouTube-Konto öffnen → einmal Reconnect. Die Warnung lautet nun anders: Advanced → Go to … (unsafe). Es bleibt deine eigene App.

Testmodus oder Produktion?

  1. Testmodus: Google beendet die Anmeldung nach sieben Tagen, obwohl Publit.Si den kurzlebigen Zugriffstoken selbst erneuert. Verbinde erneut oder wechsle zu Produktion.

  2. Produktion: Keine Sieben-Tage-Grenze. Du verbindest nur neu, wenn du den Zugriff widerrufst oder Google erneut eine Anmeldung verlangt.

  3. Welcher Modus ist aktiv? Publit.Si erkennt das nicht am Token; eine funktionierende Verbindung beweist es nicht. Prüfe Google Auth Platform → Audience → Publishing status: Testing oder In production.

Ergebnis prüfen

Settings › Platform setup › YouTube zeigt alle Punkte als eingerichtet; Accounts zeigt nach dem Verbinden deinen Kanal.

Fehlersuche

redirect_uri_mismatch
Die Weiterleitungsadresse im Dashboard muss exakt übereinstimmen, einschließlich http/https und Port.
YouTube: „Access blocked: Google's review of … was not completed“ (403 access_denied)
Dein Google-Projekt läuft im Testmodus und dein Konto steht noch nicht auf der Liste. Im eigenen Google-Projekt: Audience → Test users → + Add users, das zur Verbindung verwendete Google-Konto ergänzen, speichern und neu verbinden (SETUP.md, Schritt 5.2). Dafür sind weder Branding noch Domain oder Veröffentlichung nötig. Die Anmeldung gilt dann sieben Tage. Ohne wöchentliche Neuanmeldung: YouTube-Anleitung, Abschnitt „Optional: Ohne wöchentliche Neuanmeldung“.
YouTube: „Publish app“ ist deaktiviert und fordert vollständiges Branding
Das ist nur nötig, um wöchentliche Neuanmeldungen zu vermeiden; als Testnutzer kannst du sofort verbinden. Google benötigt Startseite, Datenschutz und Nutzungsbedingungen auf deiner Domain. Mit Cloudflare-Tunnel (SETUP.md, Schritt 3) stellt dein Gateway alle drei bereit: https://your-host/, /privacy und /terms. Ergänze die Domain unter Authorized domains und speichere. Siehe YouTube-Anleitung, Abschnitt „Optional: Ohne wöchentliche Neuanmeldung“.
YouTube: „Google hasn't verified this app“
Im Testmodus zeigt Google „You've been given access to an app that's currently being tested“: Wähle Continue. In Produktion zeigt die ungeprüfte App Advanced → Go to … (unsafe). Beides ist für dein selbst erstelltes Projekt in Ordnung. Diese Warnung unterscheidet sich von der blockierten 403-Seite, die im Testmodus einen Testnutzer-Eintrag benötigt.
YouTube verlangt nach einer Woche eine neue Anmeldung
Im Google-Testmodus endet die Anmeldung nach sieben Tagen. Verbinde erneut oder stelle dein Google-Projekt auf Produktion um (YouTube-Anleitung, Abschnitt „Optional: Ohne wöchentliche Neuanmeldung“) und verbinde einmal neu.
YouTube: Upload nicht erlaubt, insufficientPermissions oder Vorab-Uploads benötigen Neuanmeldung
Verbinde erneut. Die drei YouTube-Kästchen in Googles Berechtigungsdialog sind anfangs leer: Select all wählen, danach Continue. Vorab-Uploads benötigen auch die Berechtigung zur Verwaltung des hochgeladenen Videos; sonst lädt Publit.Si erst zum Termin hoch. Bei unvollständigen Statistiken prüfe APIs und Berechtigungen. Bietet Google keine Freigabe an, prüfe die Richtlinien- oder Bestätigungsmeldung, statt die Verbindung zu wiederholen.
YouTube: quotaExceeded oder uploadLimitExceeded
Prüfe Settings → Limits today und die API-Kontingente des Google-Projekts. Kanäle im selben Projekt teilen das Projektkontingent; zusätzlich können Kanallimits gelten. Publit.Si wartet bei begrenzten Anfragen und versucht erneut. Tägliche Projektkontingente werden um Mitternacht Pazifikzeit zurückgesetzt; Kanallimits können zusätzliche Wartezeit verlangen. Neu verbinden erhöht kein Kontingent.

Du kommst nicht weiter? Suche in der Fehlersuche oder schreibe uns . Teile keine Zugangsdaten oder Tokens.