El Explorador de APIs es una forma excelente de probar Cloud Talent Solution. El explorador muestra un formulario con los parámetros de cada método. Rellena el formulario, ejecuta la llamada a la API y consulta los resultados. Haz clic en el botón de abajo para ver el Explorador de APIs.
Aparecerá el Explorador de APIs:
Autorizar el Explorador de APIs
En primer lugar, asegúrate de que tienes los permisos de "Editor de proyectos de Cloud Talent Solution" tal como se describe en la página Control de acceso. Para ello, actualiza la sección "IAM & Admin" (IAM y administrador) de tu proyecto de Google Cloud Platform (consulta la sección Antes de empezar para obtener instrucciones sobre cómo crear un proyecto).
Haz clic en Autorizar solicitudes con OAuth 2.0. Aparecerá el formulario Seleccionar permisos de OAuth 2.0:
Selecciona los dos elementos de ámbito de la lista, tal como se indica en la captura de pantalla anterior, y haz clic en Autorizar.
Aparecerá el formulario Explorador de APIs de Cloud Talent Solution con una lista de métodos de la API.
Elegir un método
Elige el método al que quieras llamar. En este tutorial se explica cómo obtener una lista de las empresas que has creado. Si no se ha creado ninguna empresa, la respuesta será un conjunto de resultados vacío. Para crear una empresa, sigue los procedimientos generales que se indican a continuación y consulta la documentación de referencia para saber qué datos se necesitan en cada llamada a la API.
Para ver la lista de empresas que has creado, haz clic en jobs.projects.companies.list, que se muestra a continuación:
Aparecerá el formulario del método companies.list.
Rellena los parámetros
Rellena los siguientes campos del formulario:
- parent:
projects/{project-id} - pageSize
20
Sustituye {project_id} por el ID de tu proyecto, pero copia todos los demás campos sin hacer cambios.
Nota: Estos campos contienen valores de cadena, pero no incluyas comillas alrededor de los valores. Si un valor tiene cadenas internas, como filter, utiliza comillas dobles para delimitar las cadenas internas.
Ejecuta el método
Haz clic en el botón Ejecutar. Si aparece un mensaje de error, comprueba que has introducido la información tal como se indica más arriba. Haz los cambios que quieras en el formulario y vuelve a hacer clic en Ejecutar. Puede que tengas que hacer clic en Ejecutar dos veces. Si recibes un conjunto de resultados vacío, significa que aún no se ha creado ninguna empresa. Vuelve a probar este tutorial con el método jobs.projects.companies.create para crear una empresa.
Puedes explorar los métodos y formularios de la API por tu cuenta.
Nota: Cuando obtengas el resultado que quieras, añade a marcadores la URL del Explorador de APIs. Cuando quieras volver a ejecutar el método, pega la URL en tu navegador. El formulario ya se ha rellenado con sus valores. Haz los cambios que quieras y, a continuación, vuelve a autorizar el Explorador y haz clic en Ejecutar para ejecutar el método.