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 les stocker et de les traiter dans une zone géographique spécifique pour répondre aux exigences réglementaires ou aux exigences du règlement. Pour contrôler l'emplacement de vos données, vous devez spécifier un point de terminaison de service régional pour vos requêtes API.

Dans ce document, le terme emplacement fait référence à une Google Cloud région ou un emplacement multirégional où résident les données, et vos données a la même signification que "Données client" dans la section Emplacement des données des Conditions spécifiques au service.

Les engagements de 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 traitées ou transmises activement.
  • Les données sont en cours d'utilisation lorsqu'elles sont 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 de 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 dans le périmètre du réseau Google ou en sortent.

Les engagements de 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 acceptés

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 juridictionnel du machine learning (ML) (identifié par En cours d'utilisation (juridictionnel)) fait référence aux engagements de traitement du ML pour vos données. Comme défini dans les Conditions spécifiques au service, Google effectue le traitement de vos données par machine learning uniquement dans la région ou la multirégion que vous avez sélectionnée.

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

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 pour les 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 aux 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 Toute région ou zone multirégionale Non compatible
eu Union européenne Multirégional geminidataanalytics.eu.rep.googleapis.com Toute région ou zone multirégionale Au repos, En cours d'utilisation (juridictionnel)
us États-Unis Multirégional geminidataanalytics.us.rep.googleapis.com Toute 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 Toute 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 Toute région ou zone multirégionale Non compatible
eu Union européenne Multirégional geminidataanalytics.eu.rep.googleapis.com Toute région ou zone multirégionale Au repos, En cours d'utilisation (juridictionnel)
us États-Unis Multirégional geminidataanalytics.us.rep.googleapis.com Toute région ou zone multirégionale Au repos
us-east4 Virginie du Nord Régional geminidataanalytics-us-east4.googleapis.com Toute 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 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. Les points de terminaison de service pour l'API Conversational Analytics utilisent les formats suivants, selon le type de localisation :

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

Remplacez l'espace réservé LOCATION par une région unique ou multirégion 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 du 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. Tout d'abord, configurez base_url pour qu'il utilise le point de terminaison régional de votre choix, comme indiqué dans l'exemple suivant tiré de 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 d'API, comme dans cet exemple tiré de Poser des questions avec un chat avec ou 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 indiqué dans l'exemple suivant de 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 projet Google Cloud .
  • LOCATION : région ou multirégion 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 :

Étapes suivantes