Ejecuta muestras de código

cURL

Configuración

1. Sigue las instrucciones en la documentación de la API a fin de crear o seleccionar un proyecto para tu app y habilitar la API.
2. En Cloud Console, crea una clave de API.
3. En Cloud Console, crea una credencial de ID de cliente de OAuth para una aplicación web y usa https://developers.google.com/oauthplayground como el URI de redireccionamiento.
4. En OAuth 2.0 Playground, haz clic en Configuración de OAuth 2.0 settings.
5. Marca Usa tus propias credenciales.
6. Ingresa el ID de cliente y el secreto de cliente generados en el paso 3.
7. En el campo de alcances, escribe el alcance que deseas utilizar con tu método y haz clic en Autorizar API.
8. (Opcional) Si aparece una pantalla de acceso, selecciona la cuenta que deseas usar.
9. (Opcional) Si aparece una pantalla de autorización, haga clic en Aceptar.
10. Haga clic en Intercambiar código de autorización para tokens. Se muestra un token.
11. En la muestra de código cURL, reemplaza [YOUR_API_KEY] por la clave de API generada en el paso 2: 'https://www.googleapis.com/drive/v3/files?key=[YOUR_API_KEY]' \.
12. En la muestra de código cURL, reemplaza [YOUR_ACCESS_TOKEN] por el token de acceso generado en el paso 10: --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \.

Cómo ejecutar una muestra de código

Desde la línea de comandos, ejecuta el comando cURL. El comando debería ser similar al siguiente:

curl \
'https://www.googleapis.com/drive/v3/files?key=AIzaSyBiKcaoXmVApwnT24hitQG_dwjGvAj6Ddw' \
--header 'Authorization: Bearer ya29.a0ARrdaM_yQn9MWBpJgKPx880BSnRYIizRYIDz0JN9e66nSliIYpqNXmPsvv2ccfplCTG_U4b1' \
--header 'Accept: application/json' \
--compressed

JavaScript

Configuración

1. Sigue las instrucciones en la documentación de la API a fin de crear o seleccionar un proyecto para tu app y habilitar la API.
2. En Cloud Console, crea una clave de API.
3. En Cloud Console, crea una credencial de ID de cliente de OAuth para una “aplicación web” y configura los orígenes autorizados de JavaScript a fin de identificar la URL desde la que enviarás solicitudes, como http://localhost.
4. Copia la muestra de código completa en un archivo local al que pueda acceder tu servidor web, como /var/www/html/example.html.

5. Busca la línea en la muestra de código que establece la clave de API o el ID de cliente y reemplaza el valor por los valores generados en los pasos 2 y 3:

   • Clave de API: gapi.client.setApiKey(YOUR_API_KEY);
   • ID de cliente de OAuth 2.0: gapi.client.init({ 'clientId': 'YOUR_CLIENT_ID',

Cómo ejecutar una muestra de código

1. Abre el archivo en tu navegador, como http://localhost/example.html. Te recomendamos usar un navegador con una consola de depuración, como Google Chrome.
2. (Opcional) Si aparece una pantalla de acceso, selecciona la cuenta que deseas usar.
3. (Opcional) Si aparece una pantalla de autorización, haga clic en Aceptar. La consola de depuración debe mostrar la respuesta del método como un objeto JSON.

Java

Requisitos previos

• Java 1.7 o superior
• Gradle 7 o una versión posterior

Configuración

1. Sigue las instrucciones en la documentación de la API a fin de crear o seleccionar un proyecto para tu app y habilitar la API.
2. Según el tipo de datos al que acceda el método, crea una clave de API (datos públicos) o un ID de cliente de OAuth 2.0 (datos privados).
3. Configure el tipo de aplicación como Aplicación de escritorio.
4. Si creaste un ID de cliente de OAuth 2.0, descarga el archivo JSON que contiene tus credenciales de OAuth 2.0. Este archivo tiene un nombre similar a client_secret_CLIENTID.json, en el que CLIENTID es el ID de cliente de tu proyecto.

5. En el directorio de trabajo, ejecuta los siguientes comandos para crear una estructura de proyecto nueva:

   $ gradle init --type basic
   $ mkdir -p src/main/java src/main/resources
   

6. Si creaste un ID de cliente de OAuth 2.0 en el paso 2, cambia el nombre del archivo JSON que descargaste a client_secret.json.

7. Guarda el archivo al que le cambiaste el nombre en el directorio src/main/resources que creaste en el paso 5.

8. En tu directorio de trabajo, abre el archivo build.gradle y reemplaza su contenido por lo siguiente:

   apply plugin: 'java'
   apply plugin: 'application'
   
   mainClassName = 'ApiExample'
   sourceCompatibility = 1.7
   targetCompatibility = 1.7
   version = '1.0'
   
   repositories {
       mavenCentral()
   }
   
   dependencies {
       compile 'com.google.api-client:google-api-client:1.23.0'
       compile 'com.google.oauth-client:google-oauth-client-jetty:1.23.0'
       API_SPECIFIC_DEPENDENCY
   }
   

9. En el archivo build.gradle, reemplaza la línea que dice API_SPECIFIC_DEPENDENCY con una instrucción de compilación de código para la API a la que estás llamando. Este es un ejemplo para la API de YouTube Analytics:

   compile 'com.google.apis:google-api-services-youtubeAnalytics:v2-rev16-1.23.0'
   

   La instrucción sigue esta plantilla:

   compile 'com.google.apis:google-api-services-API_NAME:API_VERSION-   revREVISION-CL_VERSION'
   

Aquí:

• API_NAME es el nombre de la API que aparece en GitHub para la API. Para encontrar el nombre, haz clic en el vínculo de la versión junto a tu API en la página API de Google compatibles. El vínculo de la versión navega a GitHub. El nombre de la API está en la mitad superior de la página y está precedido por googleapis/google-apis-services-. Por ejemplo, para la v3 de la API de Drive, el API_NAME es drive.
• API_VERSION es la versión de la API que aparece para la API debajo del nombre de la API en la página de las API de Google compatibles.
• REVISION es el número de revisión que aparece en la referencia de JavaDoc para la API. La referencia de JavaDoc se puede encontrar en https://googleapis.dev/java/google-api-services-API_NAME/latest/index.html.
• CL_VERSION es la versión de la biblioteca cliente. Este valor también aparece en la referencia de JavaDoc.
• Desde tu directorio de trabajo, copia la muestra de código del Explorador de API en src/main/java/ApiExample.java. (El nombre de clase en cada muestra es ApiExample, por lo que no necesitas modificar el archivo build.gradle para ejecutar muestras diferentes.

Cómo ejecutar una muestra de código

Usa el siguiente comando para ejecutar el ejemplo:

  gradle -q run

La muestra debe ejecutar tu solicitud a la API y debe imprimir la respuesta en STDOUT. También puedes verificar el servicio al que estás llamando para ver los efectos de las solicitudes que escriben datos.

Node.js

Requisitos previos

• Node.js

• La biblioteca cliente de las API de Google para Node.js:

  • Si no instalaste la biblioteca cliente con anterioridad, ejecuta el siguiente comando:

  npm install googleapis --save
  

  • Si ya instalaste la biblioteca cliente, te recomendamos que la actualices para asegurarte de tener las clases más actualizadas de la biblioteca que estás probando. Para actualizar la biblioteca cliente, ejecuta el siguiente comando:

  npm update googleapis --save
  

Configuración

1. Sigue las instrucciones en la documentación de la API a fin de crear o seleccionar un proyecto para tu app y habilitar la API.
2. Según el tipo de datos al que acceda el método, crea una clave de API (datos públicos) o un ID de cliente de OAuth 2.0 (datos privados).
3. Configure el tipo de aplicación como Aplicación de escritorio.
4. Si creaste un ID de cliente de OAuth 2.0, descarga el archivo JSON que contiene tus credenciales de OAuth 2.0. Este archivo tiene un nombre similar a client_secret_CLIENTID.json, en el que CLIENTID es el ID de cliente de tu proyecto.
5. Copia la muestra de código en un archivo local y modifícala para identificar de manera correcta tu clave de API o el archivo de secretos del cliente. En la muestra, el valor de la clave de API es YOUR_API_KEY y la ubicación del archivo de secretos del cliente es YOUR_CLIENT_SECRET_FILE.json.

Cómo ejecutar una muestra de código

Usa el siguiente comando para ejecutar el ejemplo:

  node sample.js

La mayoría de los ejemplos imprimen una respuesta de API (o algo más) en STDOUT.

PHP

Requisitos previos

• PHP 5.4 o superior con la interfaz de línea de comandos (CLI) y la extensión JSON
• La herramienta de administración de dependencias de Composer instalada de forma global

• La biblioteca cliente de las API de Google para PHP:

  • Si no instalaste la biblioteca cliente con anterioridad, ejecuta el siguiente comando:

    composer require google/apiclient:^2.0
    

  • Si ya instalaste la biblioteca cliente, te recomendamos que la actualices a fin de asegurarte de tener las clases más actualizadas para la biblioteca que estás probando. Para actualizar la biblioteca cliente, ejecuta el siguiente comando:

    composer update google/apiclient --with-dependencies
    

Cómo ejecutar una muestra de código

Usa el siguiente comando para ejecutar el ejemplo:

  php sample.php

La mayoría de los ejemplos imprimen una respuesta de API (o algo más) en STDOUT.

Python

Requisitos previos

• Python 2.7 o Python 3.5+
• La herramienta de administración de paquetes pip

• La biblioteca cliente de las API de Google para Python:

  pip install --upgrade google-api-python-client
  

• Las bibliotecas google-auth-oauthlib y google-auth-httplib2 para la autorización del usuario:

  pip install --upgrade google-auth-oauthlib google-auth-httplib2
  

Configuración

1. Sigue las instrucciones en la documentación de la API a fin de crear o seleccionar un proyecto para tu app y habilitar la API.
2. Según el tipo de datos al que acceda el método, crea una clave de API (datos públicos) o un ID de cliente de OAuth 2.0 (datos privados).
3. Configure el tipo de aplicación como Aplicación de escritorio.
4. Si creaste un ID de cliente de OAuth 2.0, descarga el archivo JSON que contiene tus credenciales de OAuth 2.0. Este archivo tiene un nombre similar a client_secret_CLIENTID.json, en el que CLIENTID es el ID de cliente de tu proyecto.
5. Copia la muestra de código en un archivo local y modifícala para identificar de manera correcta tu clave de API o el archivo de secretos del cliente. En la muestra, el valor de la clave de API es YOUR_API_KEY y la ubicación del archivo de secretos del cliente es YOUR_CLIENT_SECRET_FILE.json.

Cómo ejecutar una muestra de código

Usa el siguiente comando para ejecutar el ejemplo:

  python sample.py

La mayoría de los ejemplos imprimen una respuesta de API (o algo más) en STDOUT.

Ruby

Requisitos previos

• Ruby 2.0 o superior

• La biblioteca cliente de las API de Google para Ruby:

  gem install google-api-client`
  

Configuración

1. Sigue las instrucciones en la documentación de la API a fin de crear o seleccionar un proyecto para tu app y habilitar la API.
2. Según el tipo de datos al que acceda el método, crea una clave de API (datos públicos) o un ID de cliente de OAuth 2.0 (datos privados).
3. Configure el tipo de aplicación como Aplicación de escritorio.
4. Si creaste un ID de cliente de OAuth 2.0, descarga el archivo JSON que contiene tus credenciales de OAuth 2.0. Este archivo tiene un nombre similar a client_secret_CLIENTID.json, en el que CLIENTID es el ID de cliente de tu proyecto.
5. Copia la muestra de código en un archivo local y modifícala para identificar de manera correcta tu clave de API o el archivo de secretos del cliente. En la muestra, el valor de la clave de API es YOUR_API_KEY y la ubicación del archivo de secretos del cliente es YOUR_CLIENT_SECRET_FILE.json.

Cómo ejecutar una muestra de código

Usa el siguiente comando para ejecutar el ejemplo:

  ruby sample.rb

La mayoría de los ejemplos imprimen una respuesta de API (o algo más) en STDOUT.