omnipost/youtube

YouTube for omnisense/omnipost: the channel and its uploads read with an API key, videos and Shorts uploaded, followed and deleted through OAuth, through the YouTube Data API v3. The provider calls:

on https://www.googleapis.com/youtube/v3 and https://www.googleapis.com/upload/youtube/v3 (Api::BASE_URI, Api::UPLOAD_URI, the base_uri and upload_uri options). There is no sandbox: a test channel is a real channel.

Installation

composer require omnisense/omnipost omnipost/youtube

Requires PHP 8.2, omnisense/omnipost (1.x) and symfony/http-client (6.4, 7 or 8). In a Symfony application with Omnipost\Bridge\Symfony\OmnipostBundle, the factory is registered as soon as the package is installed.

Credentials

• A Google Cloud project with the YouTube Data API v3 enabled.
• To read: an API key (APIs & Services, Credentials) and the channel's id (UC..., in YouTube Studio, Settings, Channel, Advanced, or the channel's URL).
• To upload, delete, or read as the channel: an OAuth client (type Web application, the site's redirect URI declared), the consent screen with the scopes youtube.upload and youtube.readonly, and the channel's account among its test users while the app is in Testing. A refresh token of an app in Testing dies after 7 days: publish the consent screen for one that lasts. Then authorizationUrl() and exchange() (Tokens); the refresh token answered is the refresh_token option.
• Quota: 10 000 units a day per project by default (the README's figures: a read costs 1 unit, an upload about 100).

Options

No option is required to build the provider (null and '' are as if not given). Post options read (Post::$options, or YouTube's variant's): privacy, category_id.

Capabilities

Behaviour

Upload. publish() validates (InvalidPostException, nothing sent), requires the OAuth credentials (InvalidConfigException before the file is read), takes the file from Media::$path or downloads Media::$url to a temporary file (300-second idle timeout), opens a resumable upload with the metadata (title, description Post::text(), tags without #, category, privacy, selfDeclaredMadeForKids: false, publishAt when scheduled), then PUTs the bytes with the media's mime type (else the download's, else video/*), with no overall time limit. The whole field-by-field mapping: Publishing.

States. From status.uploadStatus: processed is PUBLISHED - or PENDING while private with a publishAt to come; failed, rejected, deleted are FAILED with the reason; anything else PROCESSING. The permalink (https://www.youtube.com/watch?v=<id>) is set from the first answer. PUBLISHED means processed: a private video is PUBLISHED too. The videos of a project that has not passed Google's audit are locked private whatever privacy says.

Tokens. The access token is drawn from the refresh token before the first call that needs one, and again within 60 seconds of its end; Google's answer gives its end (expires_in) and may give a new refresh token, kept. An access_token option has no known end. token() is null until one is drawn.

Reading. The channel is read once per provider object. A video of 180 s at most is a REEL in the feed, a longer one a VIDEO; url is the embed player, caption the title, the thumbnail the largest given (maxres, high, standard, medium, default); maxResults between 1 and 50. Subscribers hidden by the channel are null. Details: Reading.

Example

<?php

require __DIR__.'/vendor/autoload.php';

use Omnipost\Model\Media;
use Omnipost\Model\Post;
use Omnipost\Model\Variant;
use Omnipost\Platform;
use Omnipost\YouTube\YouTubeProviderFactory;
use Symfony\Component\HttpClient\HttpClient;

$youtube = (new YouTubeProviderFactory(HttpClient::create()))->create([
    'api_key' => getenv('YOUTUBE_API_KEY'),
    'channel_id' => getenv('YOUTUBE_CHANNEL_ID'),
    'client_id' => getenv('YOUTUBE_CLIENT_ID'),
    'client_secret' => getenv('YOUTUBE_CLIENT_SECRET'),
    'refresh_token' => getenv('YOUTUBE_REFRESH_TOKEN'),
]);

$post = Post::reel(Media::video('https://site.example/media/reel.mp4', __DIR__.'/reel.mp4', 42.0, 1080, 1920), 'Strauss, tonight.', null, ['violin'])
    ->withVariant(new Variant(Platform::YOUTUBE, title: 'Strauss, Sonata in E-flat - live', options: ['privacy' => 'unlisted']));

$publication = $youtube->publish($post->for(Platform::YOUTUBE));   // PROCESSING, the video's id
$publication = $youtube->status($publication->id);                // PUBLISHED once processed

foreach ($youtube->feed(null, 5)->items as $item) {
    echo $item->publishedAt->format('Y-m-d'), ' ', $item->kind->value, ' ', $item->caption, ' ', $item->permalink, "\n";
}

The same calls were run on 2026-10-26 on a MockHttpClient (the requests and answers are in Publishing); YouTube itself was not called. In Symfony:

omnipost:
    providers:
        youtube:
            factory: youtube
            options:
                api_key: '%env(default::YOUTUBE_API_KEY)%'
                channel_id: '%env(default::YOUTUBE_CHANNEL_ID)%'
                client_id: '%env(default::YOUTUBE_CLIENT_ID)%'
                client_secret: '%env(default::YOUTUBE_CLIENT_SECRET)%'
                refresh_token: '%env(default::YOUTUBE_REFRESH_TOKEN)%'
                privacy: private
                category_id: '10'

Errors

Verified, and not

The package's tests (Tests/YouTubeProviderTest.php, 12 tests) pass (2026-10-26, PHP 8.4) on answers written in the shapes the Data API v3 documents - not recorded from YouTube. No upload or read was run against YouTube for this package (neither the README nor the history states one).

Responsibility

This package is an independent, unofficial client, not affiliated with, endorsed by or sponsored by Google LLC (YouTube). Whoever runs it complies with the YouTube API Services Terms of Service; see the README's Responsibility section.