En esta guía de inicio rápido, se explica cómo configurar una aplicación de línea de comandos de PHP simple que realiza solicitudes a la API de datos de YouTube. En esta guía de inicio rápido, se explica cómo realizar dos solicitudes a la API:
- Usarás una clave de API, que identifica tu aplicación, para recuperar información sobre el canal de YouTube de GoogleDevelopers.
- Usarás un ID de cliente de OAuth 2.0 para enviar una solicitud autorizada que obtenga información sobre tu propio canal de YouTube.
Requisitos previos
Para ejecutar esta guía de inicio rápido, necesitarás lo siguiente:
- PHP 5.4 o superior con la interfaz de línea de comandos (CLI) y la extensión JSON instalada.
- La herramienta de administración de dependencias de Composer instalada de manera global {: target="_blank"}
- La biblioteca cliente de las API de Google para PHP:
- Si no instalaste la biblioteca cliente con anterioridad:
composer require google/apiclient:^2.0
- Si ya instalaste la biblioteca cliente, te recomendamos actualizarla a fin de asegurarte de que tienes las clases más actualizadas de la biblioteca que estás probando:
composer update google/apiclient --with-dependencies
- Si no instalaste la biblioteca cliente con anterioridad:
Paso 1: Configura tu proyecto y tus credenciales
Crea o selecciona un proyecto en la Consola de API. Completa las siguientes tareas en la consola de API para tu proyecto:
En el panel de la biblioteca, busca la API de datos de YouTube versión 3. Haz clic en la lista de esa API y asegúrate de que la API esté habilitada para tu proyecto.
En el panel de credenciales, crea dos credenciales:
Crea una clave de API. La usarás para realizar solicitudes a la API que no requieran la autorización del usuario. Por ejemplo, no necesitas la autorización del usuario para recuperar información sobre un canal de YouTube público.
Crear un ID de cliente de OAuth 2.0 Establece el tipo de aplicación en Otro. Debes usar las credenciales de OAuth 2.0 para las solicitudes que requieren la autorización del usuario. Por ejemplo, necesitas la autorización del usuario para recuperar información sobre el canal de YouTube del usuario autenticado actualmente.
Descarga el archivo JSON que contiene tus credenciales de OAuth 2.0. El archivo tiene un nombre como
client_secret_CLIENTID.json
, en el queCLIENTID
es el ID de cliente de tu proyecto.
Paso 2: Configura y ejecuta la muestra
Usa el widget del Explorador de API en el panel lateral a fin de obtener un código de muestra para recuperar información sobre el canal de YouTube de GoogleDevelopers. Esta solicitud usa una clave de API para identificar tu aplicación y no requiere la autorización del usuario ni ningún permiso especial del usuario que ejecuta la muestra.
- Abre la documentación del método channels.list de la API.
En esa página, la sección "Casos prácticos comunes" contiene una tabla en la que se explican varias formas comunes en que se usa el método. La primera lista de la tabla es para enumerar los resultados por ID de canal.
Haz clic en el símbolo de código de la primera ficha para abrir y propagar el Explorador de API de pantalla completa.
En el lado izquierdo del Explorador de API de pantalla completa, se muestra lo siguiente:
Debajo del encabezado Request parameters, hay una lista de parámetros que admite el método. Se deben establecer los valores de los parámetros
part
yid
. El valor del parámetroid
,UC_x5XG1OV2P6uZZ5FSM9Ttw
, es el ID para el canal de YouTube de GoogleDevelopers.Debajo de los parámetros, hay una sección llamada Credenciales. El menú desplegable de esa sección debe mostrar el valor Clave de API. El Explorador de API usa las credenciales de demostración de forma predeterminada para que sea más fácil comenzar. Sin embargo, usarás tu propia clave de API para ejecutar la muestra de manera local.
En el lado derecho, el Explorador de API de pantalla completa muestra las pestañas con muestras de código en diferentes idiomas. Selecciona la pestaña PHP.
Copia la muestra de código y guárdala en un archivo llamado
example.php
.En la muestra que descargaste, busca la string
YOUR_API_KEY
y reemplázala por la clave de API que creaste en el paso 1 de esta guía de inicio rápido.Ejecuta la muestra desde la línea de comandos. En tu directorio de trabajo, ejecuta lo siguiente:
php example.php
La muestra debería ejecutar la solicitud y, luego, imprimir la respuesta en
STDOUT
.
Paso 3: Ejecuta una solicitud autorizada
En este paso, modificarás tu ejemplo de código para que, en lugar de recuperar información sobre el canal de YouTube de GoogleDevelopers, recupere información sobre tu canal de YouTube. Esta solicitud requiere la autorización del usuario.
Vuelve a la documentación del método channels.list de la API.
En la sección “Casos prácticos comunes”, haz clic en el símbolo de código de la tercera lista de la tabla. Ese caso práctico es llamar al método
list
para "mi canal".Nuevamente, en el lado izquierdo del Explorador de API de pantalla completa, verás una lista de parámetros seguido de la sección Credenciales. Sin embargo, hay dos cambios del ejemplo en el que recuperaste información sobre el canal GoogleDevelopers:
En la sección de parámetros, en lugar del valor del parámetro
id
, el valor del parámetromine
debe establecerse entrue
. Esto le indica al servidor de la API que recupere información sobre el canal del usuario autenticado actualmente.En la sección Credenciales, en el menú desplegable, debes seleccionar la opción de Google OAuth 2.0.
Además, si haces clic en el vínculo Mostrar alcances, se debe verificar el alcance https://www.googleapis.com/auth/youtube.readonly.
Al igual que en el ejemplo anterior, selecciona la pestaña PHP, copia la muestra de código y guárdala en
example.php
.En el código, busca la string
YOUR_CLIENT_SECRET_FILE.json
y reemplázala por la ubicación del archivo secreto de cliente que descargaste en el paso 1 de esta guía de inicio rápido.Ejecuta la muestra desde la línea de comandos. En tu directorio de trabajo, ejecuta lo siguiente:
php example.php
-
Copia la URL de la consola y ábrela en tu navegador.
Si aún no accediste a tu Cuenta de Google, se te solicitará que lo hagas. Si accediste a varias Cuentas de Google, se te pedirá que selecciones una para usar en la autorización.
Haz clic en el botón para otorgar a tu aplicación acceso a los alcances especificados en tu muestra de código.
-
Copia el código de Auth del navegador y pégalo en tu terminal. Puedes cerrar la pestaña del navegador que usaste para el flujo de Auth.
La respuesta de la API se debe volver a imprimir en
STDOUT
.
Lecturas adicionales
- Documentación de ayuda de Google Developers Console
- Documentación de la biblioteca cliente de las API de Google para PHP
- Biblioteca cliente de las API de Google para PHP en GitHub y clases generadas automáticamente para la API de YouTube. En la página, busca la carpeta
YouTube
y el archivoYouTube.php
. - Documentación de referencia de la API de datos de YouTube