リージョン指定

リージョンを指定することは、次のようなユースケースで特に役立ちます。

システムに、データの保管場所を制御する規制要件またはポリシー要件が含まれる場合があるため。
お客様と同じリージョンにデータが存在する場合、ネットワークのレイテンシが改善されることがあります。たとえば、ベルギーのお客様が europe-west1 を使用すると、レイテンシの改善が期待できます。

利用可能なリージョン

国のグルーピング	地理的位置	エンドポイント	リソースのロケーション
グローバル	グローバルなサービス提供、保存データを米国に格納	`contactcenterinsights.googleapis.com`	`us-central1`
南北アメリカ	サウスカロライナ	`us-east1-contactcenterinsights.googleapis.com`	`us-east1`
南北アメリカ	オレゴン	`us-west1-contactcenterinsights.googleapis.com`	`us-west1`
南北アメリカ	モントリオール	`northamerica-northeast1-contactcenterinsights.googleapis.com`	`northamerica-northeast1`
南北アメリカ	マルチリージョン	`us-contactcenterinsights.googleapis.com`	`us`
ヨーロッパ	ベルギー	`europe-west1-contactcenterinsights.googleapis.com`	`europe-west1`
ヨーロッパ	ロンドン	`europe-west2-contactcenterinsights.googleapis.com`	`europe-west2`
ヨーロッパ	フランクフルト	`europe-west3-contactcenterinsights.googleapis.com`	`europe-west3`
ヨーロッパ	オランダ	`europe-west4-contactcenterinsights.googleapis.com`	`europe-west4`
ヨーロッパ	チューリッヒ	`europe-west6-contactcenterinsights.googleapis.com`	`europe-west6`
アジア太平洋	東京	`asia-northeast1-contactcenterinsights.googleapis.com`	`asia-northeast1`
アジア太平洋	ソウル	`asia-northeast3-contactcenterinsights.googleapis.com`	`asia-northeast3`
アジア太平洋	ムンバイ	`asia-south1-contactcenterinsights.googleapis.com`	`asia-south1`
アジア太平洋	シンガポール	`asia-southeast1-contactcenterinsights.googleapis.com`	`asia-southeast1`
アジア太平洋	ジャカルタ	`asia-southeast2-contactcenterinsights.googleapis.com`	`asia-southeast2`
アジア太平洋	シドニー	`australia-southeast1-contactcenterinsights.googleapis.com`	`australia-southeast1`

サンプルコマンド

このタスクに必要な権限

このタスクを行うには、次の権限が必要です。

contactcenterinsights.analyses.create

REST

リクエストのデータを使用する前に、次のように置き換えます。

PROJECT_ID: 実際の Google Cloud プロジェクト ID。
LOCATION_ID: リージョンロケーション。
CONVERSATION_ID: 分析する会話の ID。この値は `createConversation` レスポンスで返されました。

HTTP メソッドと URL:

POST https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses

リクエストを送信するには、次のいずれかのオプションを展開します。

curl（Linux、macOS、Cloud Shell）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ユーザーアカウントで gcloud CLI にログインしているか、Cloud Shell を使用して自動的に gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses"

PowerShell（Windows）

注: 次のコマンドは、gcloud init または gcloud auth login を実行して、ご自分のユーザーアカウントで gcloud CLI にログインしていることを前提としています。gcloud auth list を実行すると、現在アクティブなアカウントを確認できます。

次のコマンドを実行します。

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://LOCATION_ID-contactcenterinsights.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/conversations/CONVERSATION_ID/analyses" | Select-Object -Expand Content

次のような JSON レスポンスが返されます。

{
  "name": "projects/PROJECT_ID/locations/LOCATION_ID/operations/OPERATION_ID"
}

Python クライアント

Python クライアントを使用している場合は、ホストとリソースの場所の両方を更新して、リージョンインスタンスを指すようにする必要があります。

options = ClientOptions(api_endpoint="us-east1-contactcenterinsights.googleapis.com" )
request = contact_center_insights_v1.ListConversationsRequest(
    parent=f"projects/{project_id}/locations/us-east1",
)
client = contact_center_insights_v1.ContactCenterInsightsClient(client_options=options)

Cloud Logging

ログを保存するリージョンを指定する場合は、Cloud Logging のドキュメントをご覧ください。