Ejecuta muestras de código

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

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 opció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. Si se te presenta una pantalla de acceso, selecciona la cuenta que quieres usar (opcional).
9. (Opcional) Si se te presenta una pantalla de autorización, haz clic en Aceptar.
10. Haz clic en Intercambiar código de autorización por tokens. Se muestra 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 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

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 establece los orígenes de JavaScript autorizados para 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 que uses un navegador con una consola de depuración, como Google Chrome.
2. Si se te presenta una pantalla de acceso, selecciona la cuenta que quieres usar (opcional).
3. (Opcional) Si se te presenta 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 superior
• Gradle 7 o versiones posteriores

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. 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 tu 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 OAuth 2.0 en el paso 2, cambia el nombre del archivo JSON que descargaste a client_secret.json.

7. Guarda el archivo con el nombre cambiado 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. Este es 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 se indica en GitHub. Para encontrar el nombre, haz clic en el vínculo de 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 v3 de la API de Drive, el API_NAME es drive.
• API_VERSION es la versión de la API que aparece 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 de 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 a 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).

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, luego, imprimir 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 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:

  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. 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 correctamente tu clave de API o archivo de secretos de 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.

Cómo ejecutar una 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 versiones posteriores con la interfaz de línea de comandos (CLI) y la extensión JSON
• La herramienta de administración de dependencias de Composer se instaló 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
    

Cómo ejecutar una 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. 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 correctamente tu clave de API o archivo de secretos de 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.

Cómo ejecutar una 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. 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 correctamente tu clave de API o archivo de secretos de 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.

Cómo ejecutar una 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.