Ejecuta muestras de código

cURL

Configurar

1. Sigue las instrucciones de la documentación de la API para crear o seleccionar un proyecto para tu app y habilitar la API.
2. En la consola de Cloud, crea una clave de API.
3. En la consola de Cloud, 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 la casilla de verificación Usar tus propias credenciales.
6. Ingresa el ID de cliente y el secreto del cliente que se generaron en el paso 3.
7. En el campo de permisos, escribe el permiso que deseas usar con tu método y haz clic en Autorizar APIs.
8. (Opcional) Si aparece una pantalla de acceso, selecciona la cuenta que deseas usar.
9. (Opcional) Si aparece una pantalla de autorización, haz clic en Aceptar.
10. Haz clic en Intercambiar código de autorización para tokens. Se devuelve un token.
11. En la muestra de código de cURL, reemplaza [YOUR_API_KEY] por la clave de API que se generó en el paso 2: 'https://www.googleapis.com/drive/v3/files?key=[YOUR_API_KEY]' \
12. En la muestra de código de cURL, reemplaza [YOUR_ACCESS_TOKEN] por el token de acceso que se generó en el paso 10: --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \

Ejecutar 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

Configurar

1. Sigue las instrucciones de la documentación de la API para crear o seleccionar un proyecto para tu app y habilitar la API.
2. En la consola de Cloud, 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 para identificar la URL desde la que enviarás solicitudes, como http://localhost.
4. Copia el ejemplo de código completo en un archivo local al que pueda acceder tu servidor web, como /var/www/html/example.html.

5. Busca la línea en el ejemplo 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',

Ejecutar muestra de código

1. Abre el archivo en tu navegador, por ejemplo, http://localhost/example.html. Te recomendamos que uses 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, haz clic en Aceptar. La consola de depuración debería mostrar la respuesta del método como un objeto JSON.

Java

Requisitos previos

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

Configurar

1. Sigue las instrucciones de la documentación de la API para crear o seleccionar un proyecto para tu app y habilitar la API.
2. Según el tipo de datos a los que accede el método, crea una clave de API (datos públicos) o un ID de cliente de OAuth 2.0 (datos privados).
3. Configura el tipo de aplicación como App 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. El nombre de este archivo es similar a client_secret_CLIENTID.json, donde CLIENTID es el ID de cliente de tu proyecto.

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

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

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

7. Guarda el archivo renombrado 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 por una instrucción para compilar código para la API a la que llamas. A continuación, se muestra un ejemplo de 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'
   

Donde:

• API_NAME es el nombre de la API que aparece en GitHub. Para encontrar el nombre, haz clic en el vínculo de la versión junto a tu API en la página APIs de Google compatibles. El vínculo de la versión te dirige a GitHub. El nombre de la API se encuentra en la parte superior central de la página y está precedido por googleapis/google-apis-services-. Por ejemplo, para la versión 3 de la API de Drive, API_NAME es drive.
• API_VERSION es la versión de la API que se indica debajo del nombre de la API en la página APIs de Google compatibles.
• REVISION es el número de revisión que se indica en la referencia de JavaDoc para la API. Puedes encontrar la referencia de JavaDoc 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 APIs en src/main/java/ApiExample.java. (El nombre de la clase en cada muestra es ApiExample para que no tengas que modificar el archivo build.gradle para ejecutar diferentes muestras.

Ejecutar muestra de código

Usa el siguiente comando para ejecutar el ejemplo:

  gradle -q run

La muestra debería ejecutar tu solicitud a la API y mostrar la respuesta en STDOUT. También puedes verificar el servicio al que llamas para ver los efectos de las solicitudes que escriben datos.

Node.js

Requisitos previos

• Node.js

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

  • Si no instalaste la biblioteca cliente anteriormente, 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 recientes de la biblioteca que estás probando. Para actualizar la biblioteca cliente, ejecuta el siguiente comando:

  npm update googleapis --save
  

Configurar

1. Sigue las instrucciones de la documentación de la API para crear o seleccionar un proyecto para tu app y habilitar la API.
2. Según el tipo de datos a los que accede el método, crea una clave de API (datos públicos) o un ID de cliente de OAuth 2.0 (datos privados).
3. Configura el tipo de aplicación como App 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. El nombre de este archivo es similar a client_secret_CLIENTID.json, donde 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 correctamente tu clave de API o el archivo de secretos del cliente. En el ejemplo, 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.

Ejecutar muestra de código

Usa el siguiente comando para ejecutar el ejemplo:

  node sample.js

La mayoría de las muestras imprimen una respuesta de la API (o algo más) en STDOUT.

PHP

Requisitos previos

• PHP 5.4 o una versión posterior 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 APIs de Google para PHP:

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

    composer require google/apiclient:^2.0
    

  • Si instalaste la biblioteca cliente anteriormente, 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:

    composer update google/apiclient --with-dependencies
    

Ejecutar muestra de código

Usa el siguiente comando para ejecutar el ejemplo:

  php sample.php

La mayoría de las muestras imprimen una respuesta de la API (o algo más) en STDOUT.

Python

Requisitos previos

• Python 2.7 o Python 3.5 (o versiones posteriores)
• La herramienta de administración de paquetes pip

• La biblioteca cliente de las APIs 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
  

Configurar

1. Sigue las instrucciones de la documentación de la API para crear o seleccionar un proyecto para tu app y habilitar la API.
2. Según el tipo de datos a los que accede el método, crea una clave de API (datos públicos) o un ID de cliente de OAuth 2.0 (datos privados).
3. Configura el tipo de aplicación como App 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. El nombre de este archivo es similar a client_secret_CLIENTID.json, donde 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 correctamente tu clave de API o el archivo de secretos del cliente. En el ejemplo, 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.

Ejecutar muestra de código

Usa el siguiente comando para ejecutar el ejemplo:

  python sample.py

La mayoría de las muestras imprimen una respuesta de la API (o algo más) en STDOUT.

Ruby

Requisitos previos

• Ruby 2.0 o una versión posterior

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

  gem install google-api-client`
  

Configurar

1. Sigue las instrucciones de la documentación de la API para crear o seleccionar un proyecto para tu app y habilitar la API.
2. Según el tipo de datos a los que accede el método, crea una clave de API (datos públicos) o un ID de cliente de OAuth 2.0 (datos privados).
3. Configura el tipo de aplicación como App 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. El nombre de este archivo es similar a client_secret_CLIENTID.json, donde 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 correctamente tu clave de API o el archivo de secretos del cliente. En el ejemplo, 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.

Ejecutar muestra de código

Usa el siguiente comando para ejecutar el ejemplo:

  ruby sample.rb

La mayoría de las muestras imprimen una respuesta de la API (o algo más) en STDOUT.