> ## Documentation Index
> Fetch the complete documentation index at: https://docs.riqra.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Habilitar y restringir API Keys en Google Cloud Platform 

> ❗️ Esta configuración es necesaria para: Obtener los API keys (Maps JavaScript API) necesarias para utilizar Google maps en la plataforma de Riqra.…

❗️ Esta configuración es necesaria para:

* Obtener los **API keys** (Maps JavaScript API) necesarias para utilizar Google maps en la plataforma de Riqra.
* Restringir las claves por motivos de facturación.

*✅ El API key es un identificador único utilizado para acreditar las peticiones asociadas a proyectos para fines de uso y facturación.*

*Si aún no configuraste tu cuenta de Google Cloud Platform, conoce cómo [aquí.](https://help.riqra.com/hc/es-419/articles/360050523293)*

## Habilitar los API key necesarios para usar mapas de google maps en la plataforma de ecommerce:

1\. Ingresar a [Google Cloud Platform Console](https://console.cloud.google.com/projectselector2/google/maps-apis/)

<img src="https://mintcdn.com/riqra-6746389f/3kGi7UwY_fmYGp8k/ecommerce/images/mceclip0-24.png?fit=max&auto=format&n=3kGi7UwY_fmYGp8k&q=85&s=7c5238c040e74b815d65a8062a21a45f" alt="mceclip0.png" width="425" height="212" data-path="ecommerce/images/mceclip0-24.png" />

2\. Hacer clic en el menú desplegable de proyectos y seleccionar o crear el proyecto para el cual se necesita añadir un API key.

<img src="https://mintcdn.com/riqra-6746389f/3kGi7UwY_fmYGp8k/ecommerce/images/mceclip1-26.png?fit=max&auto=format&n=3kGi7UwY_fmYGp8k&q=85&s=18ae55330d67dd585c9bf0c79482dbf6" alt="mceclip1.png" width="265" height="110" data-path="ecommerce/images/mceclip1-26.png" />

3\. Clic en el botón <img src="https://mintcdn.com/riqra-6746389f/yNjv3Itr7kUqtpXV/ecommerce/images/nav-menu.png?fit=max&auto=format&n=yNjv3Itr7kUqtpXV&q=85&s=b587d07778ef653bc27d8773f825d98b" alt="" width="94" height="68" data-path="ecommerce/images/nav-menu.png" /> y luego seleccionar **APIs y Servicios ➡️** Clic en **biblioteca**

**<img src="https://mintcdn.com/riqra-6746389f/99C2TlPN4YAyaCsx/ecommerce/images/mceclip3-14.png?fit=max&auto=format&n=99C2TlPN4YAyaCsx&q=85&s=44cc7ad9f9e5f4e61d024f67c5522263" alt="mceclip3.png" width="425" height="338" data-path="ecommerce/images/mceclip3-14.png" />**

4\. Luego buscar y seleccionar APIs por proyecto ➡️ Buscar Maps en el buscador o seleccionar **ver todas (15)** en la sección de maps

<img src="https://mintcdn.com/riqra-6746389f/99C2TlPN4YAyaCsx/ecommerce/images/mceclip4-10.png?fit=max&auto=format&n=99C2TlPN4YAyaCsx&q=85&s=63294ef59d81577e6d822d72fad2c1b2" alt="mceclip4.png" width="425" height="203" data-path="ecommerce/images/mceclip4-10.png" />

a. Habilitar ➡️ Maps JavaScript API

<img src="https://mintcdn.com/riqra-6746389f/99C2TlPN4YAyaCsx/ecommerce/images/mceclip5-6.png?fit=max&auto=format&n=99C2TlPN4YAyaCsx&q=85&s=ac3afd925b46b1b964f6b8a9e4451187" alt="mceclip5.png" width="348" height="196" data-path="ecommerce/images/mceclip5-6.png" />

b. Habilitar ➡️ Places API

<img src="https://mintcdn.com/riqra-6746389f/99C2TlPN4YAyaCsx/ecommerce/images/mceclip3-15.png?fit=max&auto=format&n=99C2TlPN4YAyaCsx&q=85&s=26babe97e78304d900b0b827d4adacbc" alt="mceclip3.png" width="460" height="190" data-path="ecommerce/images/mceclip3-15.png" />

c. Habilitar ➡️ Maps Embed API

<img src="https://mintcdn.com/riqra-6746389f/99C2TlPN4YAyaCsx/ecommerce/images/mceclip6-6.png?fit=max&auto=format&n=99C2TlPN4YAyaCsx&q=85&s=243ff29833e7e5962d020463ddc1fbaf" alt="mceclip6.png" width="543" height="197" data-path="ecommerce/images/mceclip6-6.png" />

d. Habilitar ➡️ Maps Static API

<img src="https://mintcdn.com/riqra-6746389f/yNjv3Itr7kUqtpXV/ecommerce/images/mceclip7-5.png?fit=max&auto=format&n=yNjv3Itr7kUqtpXV&q=85&s=5a03e4980a1f722ed4ef165d0e242c96" alt="mceclip7.png" width="470" height="199" data-path="ecommerce/images/mceclip7-5.png" />

e. **\[OPCIONAL]** Si es requerida la funcionalidad de **Geocoding,** habilitar ➡️ API: Geocoding API

<img src="https://mintcdn.com/riqra-6746389f/3txsikB51GC36jys/ecommerce/images/mceclip2-21.png?fit=max&auto=format&n=3txsikB51GC36jys&q=85&s=d87faee22adda974ef294392b862092a" alt="mceclip2.png" width="490" height="211" data-path="ecommerce/images/mceclip2-21.png" />

\*El API de Geocoding es requerido cuando se necesita transformar la ubicación ingresada en el mapa por el usuario a una dirección real.

## Restringir los API key: Por proyecto

1\. Clic en el botón <img src="https://mintcdn.com/riqra-6746389f/yNjv3Itr7kUqtpXV/ecommerce/images/nav-menu.png?fit=max&auto=format&n=yNjv3Itr7kUqtpXV&q=85&s=b587d07778ef653bc27d8773f825d98b" alt="" width="94" height="68" data-path="ecommerce/images/nav-menu.png" /> y luego seleccionar **APIs y Servicios ➡️** **Clic en Credenciales**

**<img src="https://mintcdn.com/riqra-6746389f/yNjv3Itr7kUqtpXV/ecommerce/images/mceclip9-2.png?fit=max&auto=format&n=yNjv3Itr7kUqtpXV&q=85&s=c7737361a19ce642b1e72c69a6fa0584" alt="mceclip9.png" width="425" height="490" data-path="ecommerce/images/mceclip9-2.png" />**

2\. Clic en **Crear credenciales** y **clave de API**

**<img src="https://mintcdn.com/riqra-6746389f/3txsikB51GC36jys/ecommerce/images/mceclip10-2.png?fit=max&auto=format&n=3txsikB51GC36jys&q=85&s=805737cf330edf67e4af331befe441d5" alt="mceclip10.png" width="425" height="159" data-path="ecommerce/images/mceclip10-2.png" />**

3\. Luego clic en **restringir clave**

**<img src="https://mintcdn.com/riqra-6746389f/3txsikB51GC36jys/ecommerce/images/mceclip11-1.png?fit=max&auto=format&n=3txsikB51GC36jys&q=85&s=37b1fa3616065363434c4545fc9afb46" alt="mceclip11.png" width="425" height="199" data-path="ecommerce/images/mceclip11-1.png" />**

i. Asignar un nombre

<img src="https://mintcdn.com/riqra-6746389f/3txsikB51GC36jys/ecommerce/images/mceclip12-1.png?fit=max&auto=format&n=3txsikB51GC36jys&q=85&s=da104c0a7fb4925bb3d030c5d6cf6e70" alt="mceclip12.png" width="425" height="57" data-path="ecommerce/images/mceclip12-1.png" />

ii. En restricciones de aplicación ➡️ Seleccionar **URLs referentes HTTP (sitios web)**

**<img src="https://mintcdn.com/riqra-6746389f/3txsikB51GC36jys/ecommerce/images/mceclip13.png?fit=max&auto=format&n=3txsikB51GC36jys&q=85&s=fd5d0e6681ff4e9322f276116d8fdece" alt="mceclip13.png" width="425" height="200" data-path="ecommerce/images/mceclip13.png" />**

📌 Nota: ¿Cómo restrinjo mi clave de API a sitios web concretos?

Usa una URL referente con formato HTTP para restringir las URL que pueden utilizar claves de API. [Más información](https://cloud.google.com/docs/authentication/api-keys#adding%5Fhttp%5Frestrictions)

A continuación tienes algunos ejemplos de URLs que puedes permitir que creen una URL referente:

* Una URL concreta con una ruta exacta: **[www.example.com/ruta](http://www.example.com/ruta)**
* Cualquier URL de un solo dominio sin subdominios que use el asterisco (\*): **.example.com/\***
* Cualquier URL de un subdominio único, que se especifica con el asterisco (\*): **sub.example.com/\***
* Cualquier URL de un subdominio o una ruta, especificada con el asterisco (\*): **\*.example.com/\***
* URL con un puerto no estándar: **[www.example.com:8000/\\](http://www.example.com:8000/\\)**\*

Actualmente Google no admite los parámetros y fragmentos de consultas; se omitirán si los incluyes en un referente HTTP.

iii. En restricciones de sitios web ➡️ Ingresar el dominio o URL de la plataforma de Riqra donde se utilizarán los mapas.

**⚠️ Al final de esta URL se debe incluir** ➡️ **/\*  ⬅️ para que pueda funcionar en toda la tienda**

<img src="https://mintcdn.com/riqra-6746389f/3kGi7UwY_fmYGp8k/ecommerce/images/mceclip0-25.png?fit=max&auto=format&n=3kGi7UwY_fmYGp8k&q=85&s=dddeaa3f4a155d5838f9f9e41bd07f76" alt="mceclip0.png" width="554" height="439" data-path="ecommerce/images/mceclip0-25.png" />

📌 Nota: En el caso de manejar tiendas con múltiples dominios crear un nuevo elemento por cada una de las URL. ⚠️

iv. En restricciones de API ➡️ Seleccionar **Restringir clave**

<img src="https://mintcdn.com/riqra-6746389f/3txsikB51GC36jys/ecommerce/images/mceclip15.png?fit=max&auto=format&n=3txsikB51GC36jys&q=85&s=3aa352a0c5f2cb0c8e85122c4af09d43" alt="mceclip15.png" width="425" height="132" data-path="ecommerce/images/mceclip15.png" />

v. Luego, seleccionar todos los API habilitados

☝️ \*Si se incluyó la API de Geocoding no olvidar seleccionarla en este paso

<img src="https://mintcdn.com/riqra-6746389f/3txsikB51GC36jys/ecommerce/images/mceclip16.png?fit=max&auto=format&n=3txsikB51GC36jys&q=85&s=0b60302fb4b3135a326923c2c1b1e1dd" alt="mceclip16.png" width="425" height="105" data-path="ecommerce/images/mceclip16.png" />

<img src="https://mintcdn.com/riqra-6746389f/3txsikB51GC36jys/ecommerce/images/mceclip19.png?fit=max&auto=format&n=3txsikB51GC36jys&q=85&s=f6d51dc9304bdd450f8609e5727bfbdb" alt="mceclip19.png" width="425" height="158" data-path="ecommerce/images/mceclip19.png" />

<img src="https://mintcdn.com/riqra-6746389f/99C2TlPN4YAyaCsx/ecommerce/images/mceclip20.png?fit=max&auto=format&n=99C2TlPN4YAyaCsx&q=85&s=ab82bb7729a4ab37fc29a00c8bf98877" alt="mceclip20.png" width="425" height="154" data-path="ecommerce/images/mceclip20.png" />

Al inicio de la página, en la esquina derecha superior se encuentra la clave **API key que necesitas enviar por correo a [soporte@riqra.com](mailto:soporte@riqra.com)**

vi. Clic en **guardar**

¡Listo! 🌟

Debes tener en cuenta que puede tomar tiempo para que se apliquen las configuraciones.
