Résidence des données

Cette page explique comment l'API Conversational Analytics gère 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 de conformité. 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 fournissant des contrôles sur l'emplacement des données client dans différents états :

  • Les données sont au repos lorsqu'elles sont stockées dans un espace de 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 en cours d'utilisation sont spécifiques au traitement ML juridictionnel et ne fournissent pas de résidence complète pour tous les états des données en cours d'utilisation.
  • Les données sont en transit lorsqu'elles entrent ou sortent du périmètre du réseau Google.

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 étiquettes 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 de ML pour vos données. Comme défini dans les Conditions spécifiques du service, Google n'effectue le traitement de vos données par machine learning que dans la région ou l'emplacement multirégional que vous avez sélectionnés.

Les sections suivantes fournissent des détails sur la compatibilité de la résidence des données pour les agents et les conversations qui utilisent des 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 en cours d'utilisation. 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 tout emplacement multirégional Non compatible
eu Union européenne Multirégional geminidataanalytics.eu.rep.googleapis.com Toute région ou tout emplacement multirégional Au repos, En cours d'utilisation (juridictionnel)
us États-Unis Multirégional geminidataanalytics.us.rep.googleapis.com Toute région ou tout emplacement multirégional Au repos, En cours d'utilisation (juridictionnel)
asia-northeast1 Tokyo Régional geminidataanalytics-asia-northeast1.googleapis.com Toute région ou tout emplacement multirégional Au repos, En cours d'utilisation (juridictionnel)
northamerica-northeast1 Montréal Régional geminidataanalytics-northamerica-northeast1.googleapis.com Toute région ou tout emplacement multirégional Au repos, En cours d'utilisation (juridictionnel)
northamerica-northeast2 Toronto Régional geminidataanalytics-northamerica-northeast2.googleapis.com Toute région ou tout emplacement multirégional Au repos, En cours d'utilisation (juridictionnel)
us-east4 Virginie du Nord Régional geminidataanalytics-us-east4.googleapis.com Toute région ou tout emplacement multirégional 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 tout emplacement multirégional Non compatible
eu Union européenne Multirégional geminidataanalytics.eu.rep.googleapis.com Toute région ou tout emplacement multirégional Au repos
us États-Unis Multirégional geminidataanalytics.us.rep.googleapis.com Toute région ou tout emplacement multirégional Au repos
us-east4 Virginie du Nord Régional geminidataanalytics-us-east4.googleapis.com Toute région ou tout emplacement multirégional 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. Lorsque vous appelez des points de terminaison régionaux, l'emplacement dans le chemin d'accès 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 ou le parent de la requête (par exemple, /locations/us ou projects/PROJECT_ID/locations/us).

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

  • Global : 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 prise en charge ou un emplacement multirégional pour votre source de données. Pour en savoir plus, consultez Emplacements de données compatibles.

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, construisez l'URL de la requête avec l'URL de base régionale. Tout d'abord, configurez base_url pour utiliser le point de terminaison régional de votre choix, comme indiqué 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 lors de la construction des URL pour les requêtes API, comme dans cet exemple tiré de Poser des questions avec un chat avec 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 projet Google Cloud .
  • LOCATION : région ou emplacement multirégional où vous souhaitez créer vos ressources. Pour connaître les emplacements compatibles avec chaque source de données, consultez Emplacements de données compatibles.

Limites

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

Étapes suivantes