Résidence des données

Cette page explique comment l'API Conversational Analytics est compatible avec la résidence des données. La résidence des données fait référence à l'emplacement physique de vos données et aux engagements de stockage et de traitement de vos données dans une zone géographique spécifique pour répondre aux exigences réglementaires ou aux règles. Pour contrôler l'emplacement de vos données, vous spécifiez un point de terminaison de service régional pour vos requêtes API.

Dans ce document, l'emplacement fait référence à une Google Cloud région ou à une zone multirégionale où les données résident, et vos données ont la même signification que "Données client" dans la section Emplacement des données des Conditions spécifiques des services.

Les engagements relatifs à la résidence des données pour l'API Conversational Analytics varient selon que votre agent se connecte à BigQuery ou à Looker.

Champ d'application de la résidence des données

L'API Conversational Analytics vous aide à répondre aux exigences de résidence des données en vous permettant de contrôler l'emplacement des données client dans différents états :

  • Les données sont au repos lorsqu'elles sont stockées dans un stockage persistant, plutôt que d'être activement traitées ou transmises.
  • Les données sont en cours d'utilisation lorsqu'elles se trouvent en mémoire, par exemple lorsque des modèles de machine learning (ML) traitent des données pour générer une réponse ou lorsque le service exécute une requête. Pour l'API Conversational Analytics, les engagements relatifs à la résidence des données utilisées sont spécifiques au traitement ML juridictionnel et ne fournissent pas de résidence complète pour tous les états des données utilisées.
  • Les données sont en transit lorsqu'elles entrent ou sortent du périmètre du réseau Google.

Les engagements relatifs à la résidence des données pour l'API Conversational Analytics s'appliquent aux ressources DataAgent (y compris les configurations client, le contexte, les instructions système et les exemples de requêtes) et aux ressources Conversation (y compris le contenu des messages et l'historique des états). Ces engagements ne s'appliquent pas aux données de service, telles que les identifiants et les libellés de ressources, ni aux données en transit.

Emplacements de données compatibles

L'API Conversational Analytics est compatible avec les emplacements mondiaux, régionaux et multirégionaux. Lorsque vous utilisez un point de terminaison régional ou multirégional, vous contrôlez l'emplacement où vos données sont stockées au repos.

Dans les tableaux suivants, le traitement de machine learning (ML) juridictionnel (identifié comme En cours d'utilisation (juridictionnel)) fait référence aux engagements de traitement ML pour vos données. Comme défini dans les Conditions spécifiques des services, Google n'effectue le traitement de machine learning de vos données que dans la région ou la zone multirégionale que vous avez sélectionnée.

Les sections suivantes fournissent des informations sur la compatibilité avec la résidence des données pour les agents et les conversations qui utilisent BigQuery et Looker sources de données.

Données BigQuery

Pour les agents de données qui se connectent à BigQuery, les points de terminaison régionaux et multirégionaux sont compatibles avec la résidence des données au repos et le traitement ML juridictionnel pour les données utilisées. Quel que soit l'emplacement du point de terminaison que vous spécifiez, l'agent peut se connecter à des ensembles de données BigQuery dans n'importe quel emplacement ou combinaison d'emplacements :

Emplacement Description de l'emplacement Type de point de terminaison URL du point de terminaison Emplacement de l'ensemble de données Compatibilité avec la résidence des données
global Monde Monde geminidataanalytics.googleapis.com N'importe quelle région ou zone multirégionale Non compatible
eu Union européenne Multirégional geminidataanalytics.eu.rep.googleapis.com N'importe quelle région ou zone multirégionale Au repos, En cours d'utilisation (juridictionnel)
us États-Unis Multirégional geminidataanalytics.us.rep.googleapis.com N'importe quelle région ou zone multirégionale Au repos, En cours d'utilisation (juridictionnel)
us-east4 Virginie du Nord Régional geminidataanalytics-us-east4.googleapis.com N'importe quelle région ou zone multirégionale Au repos, En cours d'utilisation (juridictionnel)

Données Looker

Pour les agents de données qui se connectent à Looker, les points de terminaison régionaux et multirégionaux sont compatibles avec la résidence des données au repos. Quel que soit l'emplacement du point de terminaison que vous spécifiez, l'agent peut se connecter à des sources de données dans n'importe quel emplacement ou combinaison d'emplacements :

Emplacement Description de l'emplacement Type de point de terminaison URL du point de terminaison Emplacement de l'ensemble de données Compatibilité avec la résidence des données
global Monde Monde geminidataanalytics.googleapis.com N'importe quelle région ou zone multirégionale Non compatible
eu Union européenne Multirégional geminidataanalytics.eu.rep.googleapis.com N'importe quelle région ou zone multirégionale Au repos
us États-Unis Multirégional geminidataanalytics.us.rep.googleapis.com N'importe quelle région ou zone multirégionale Au repos
us-east4 Virginie du Nord Régional geminidataanalytics-us-east4.googleapis.com N'importe quelle région ou zone multirégionale Au repos

Pour obtenir la liste complète des points de terminaison régionaux et multirégionaux disponibles, consultez la page Emplacements de l'API Conversational Analytics.

Appliquer la résidence des données avec des points de terminaison régionaux

Pour appliquer la résidence des données à vos ressources DataAgent et Conversation, utilisez un point de terminaison régional lorsque vous les créez et y accédez. Lorsque vous appelez des points de terminaison régionaux, l'emplacement dans le chemin d'accès à votre requête ou le parent de la requête doit correspondre à l'emplacement du point de terminaison que vous appelez. Par exemple, si vous appelez le point de terminaison geminidataanalytics.us.rep.googleapis.com, vous devez spécifier us dans le chemin d'accès à votre requête ou le parent de la requête (par exemple, /locations/us ou projects/PROJECT_ID/locations/us).

Les points de terminaison de service pour l'API Conversational Analytics utilisent les formats suivants, en fonction du type d'emplacement :

  • Monde : geminidataanalytics.googleapis.com
  • Multirégional: geminidataanalytics.LOCATION.rep.googleapis.com
  • Régional : geminidataanalytics-LOCATION.googleapis.com

Remplacez l'espace réservé LOCATION par une région unique ou une zone multirégionale compatible, telle que eu, us ou us-east4.

Les exemples suivants montrent comment configurer un point de terminaison régional pour les requêtes HTTP et SDK Python :

HTTP

Pour utiliser un point de terminaison régional avec HTTP, créez l'URL de la requête avec l'URL de base régionale. Commencez par configurer le base_url pour utiliser le point de terminaison régional de votre choix, comme illustré dans l'exemple suivant de la section Configurer les paramètres initiaux et l'authentification :

project_id = "PROJECT_ID"
location = "LOCATION"

# Set the base URL based on location.
if not location or location == "global":
  base_url = "https://geminidataanalytics.googleapis.com"
elif "-" in location:
  # Regional endpoints
  base_url = f"https://geminidataanalytics-{location}.googleapis.com"
else:
  # Multi-regional endpoints
  base_url = f"https://geminidataanalytics.{location}.rep.googleapis.com"

Ensuite, utilisez la variable base_url lorsque vous créez des URL pour les requêtes API, comme dans cet exemple de la section Poser des questions avec un chat avec état et sans état :

# Example API request URL construction using base_url:
chat_url = f"{base_url}/v1beta/projects/{project_id}/locations/{location}:chat"

SDK Python

Pour utiliser un point de terminaison régional avec le SDK Python, transmettez client_options avec le paramètre régional api_endpoint lors de l'initialisation des clients API, comme illustré dans l'exemple suivant de la section Configurer les paramètres et initialiser les clients.

from google.cloud import geminidataanalytics
from google.api_core import client_options

project_id = "PROJECT_ID"
location = "LOCATION"

# Set client options based on location.
if not location or location == "global":
  endpoint = "geminidataanalytics.googleapis.com"
elif "-" in location:
  # Regional endpoints
  endpoint = f"geminidataanalytics-{location}.googleapis.com"
else:
  # Multi-regional endpoints
  endpoint = f"geminidataanalytics.{location}.rep.googleapis.com"
opts = client_options.ClientOptions(api_endpoint=endpoint)

# Use client options when initializing API clients.
data_agent_client = geminidataanalytics.DataAgentServiceClient(client_options=opts)
data_chat_client = geminidataanalytics.DataChatServiceClient(client_options=opts)

# Use clients to make API requests. For example:
# response = data_chat_client.chat(request=request)

Remplacez les exemples de valeurs comme suit :

  • PROJECT_ID : ID de votre Google Cloud projet.
  • LOCATION : région ou zone multirégionale dans laquelle vous souhaitez créer vos ressources. Pour utiliser l'un des points de terminaison régionaux, spécifiez eu, us ou us-east4.

Limites

Lorsque vous utilisez des points de terminaison régionaux, tenez compte des points suivants :

Étape suivante