YouTube operational API

YouTube operational API works when YouTube Data API v3 fails.

Install your own instance of the API:

1. If you do not own a server, then I recommend Oracle always free VPS (see https://docs.oracle.com/en-us/iaas/Content/FreeTier/freetiertopic-AlwaysFree_Resources.htm). Note that at account creation only some home regions, including Marseille (France), propose more powerful Ampere A1 shapes.

2. If not already hosting a website (click here if you prefer nginx), run in a terminal:

On Linux (Debian, Mint and Ubuntu):

sudo apt install apache2 php git sudo a2enmod rewrite headers

Replace AllowOverride None with AllowOverride All in <Directory /var/www/> in /etc/apache2/apache2.conf.

Then run:

sudo service apache2 restart

On Windows:

Download and run WampServer 3.

On MacOS:

Install brew by following https://brew.sh#install.

On MacOS (Intel) use /usr/local/ instead of /opt/homebrew/.

```zsh brew install apache2 php

echo 'LoadModule php_module /opt/homebrew/opt/php/lib/httpd/modules/libphp.so Include /opt/homebrew/etc/httpd/extra/httpd-php.conf' >> /opt/homebrew/etc/httpd/httpd.conf

echo ' SetHandler application/x-httpd-php

DirectoryIndex index.php ' >> /opt/homebrew/etc/httpd/extra/httpd-php.conf

sed -i '' 's/#LoadModule rewritemodule/LoadModule rewritemodule/' /opt/homebrew/etc/httpd/httpd.conf ```

Replace AllowOverride None with AllowOverride All in <Directory "/opt/homebrew/var/www"> in /opt/homebrew/etc/httpd/httpd.conf.

Then run:

brew services start httpd

1. Now that you are hosting a website, get the current working directory of your terminal into the folder that is online.

• On Linux, use cd /var/www/html/
• On Windows, use cd C:\wamp64\www\
• On MacOS, use cd /opt/homebrew/var/www/

1. Clone this repository by using:

sh git clone https://github.com/Benjamin-Loison/YouTube-operational-API

1. Install Protobuf dependency:

On Linux (Ubuntu, Debian and Mint):

sh sudo apt install composer protobuf-compiler

On Windows:

Download composer.

Download protoc.

On MacOS:

sh brew install composer protobuf

In YouTube-operational-API/ clone folder:

sh composer require google/protobuf

Generate code of PHP objects from .proto prototypes:

On Linux and MacOS:

sh protoc --php_out=proto/php/ --proto_path=proto/prototypes/ $(find proto/prototypes/ -type f)

On Windows:

batch for /f "usebackq tokens=*" %a in (`dir /S /B "proto/prototypes"`) do protoc --php_out=proto/php/ --proto_path=proto/prototypes/ %a

1. Verify that your API instance is reachable by trying to access:

• On Linux and Windows: http://localhost/YouTube-operational-API/
• On MacOS: http://localhost:8080/YouTube-operational-API/

If you want me to advertise your instance (if you have opened your port, and have a fixed IP address or a domain name), please use below contacts.

Run the API with Docker

1. Install Docker and make sure that its daemon is running.

2. Create a .env file and update it with your preferred port:

sh cp .env.sample .env

1. Start the container with docker-compose:

```sh

start in the foreground

docker-compose up

start in the background

docker-compose up -d ```

1. Verify that your API instance is reachable by trying to access:
2. http://localhost:8080 (update preferred port if not 8080)

Contact:

• Matrix
• Discord

Contributing:

See CONTRIBUTING.md.