---
title: Google Cloud Storage コネクタ構成ガイド
description: この記事では、Google Cloud Storage コネクタの構成方法について説明します。
url: https://docs.tealium.com/ja/server-side-connectors/google-cloud-storage-connector/
---
## API情報

このコネクタは以下のベンダーAPIを使用します：

* API名：Google Cloud Storage API
* APIバージョン：v1
* APIエンドポイント：`https://storage.googleapis.com/`
* ドキュメント：[Google Cloud Storage API](https://cloud.google.com/storage/docs/json_api)

## バッチ制限

このコネクタは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

* 最大リクエスト数：100,000
* 最古のリクエストからの最大時間：10分
* リクエストの最大サイズ：100 MB

## 構成

コネクタマーケットプレイスにアクセスし、新しいコネクタを追加します。コネクタの追加方法についての一般的な指示については、[コネクタについて](https://docs.tealium.com/about-connectors/)を参照してください。

コネクタを追加した後、以下の構成を構成します：

* **プロジェクトID**：接続するプロジェクトIDを選択します。

## アクション

| アクション名 | AudienceStream | EventStream |
| --- | :---: | :---: |
| すべてのイベントデータを送信 | ✗ | ✓ |
| カスタムイベントデータを送信 | ✗ | ✓ |
| すべての訪問データを送信 | ✓ | ✗ |
| カスタム訪問データを送信 | ✓ | ✗ |
| ログイベントを送信 | ✗ | ✓ |
| すべてのログイベントを送信 | ✗ | ✓ |

アクションの名前を入力し、ドロップダウンメニューからアクションタイプを選択します。

次のセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

### すべてのイベントデータを送信

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| バケット | オブジェクトを作成するバケットを選択します。 |
| オブジェクトパス | データを追加するオブジェクトのパスを指定します。 |
| オブジェクトパスサフィックス | ファイルパスに動的なサフィックス（例：タイムスタンプ）を追加する属性を選択します。複数のサフィックス値が提供される場合、それらはアンダースコア文字で区切られます。 |
| レコードサフィックス | <ul><li>各レコードの末尾に追加するサフィックスとしてのデリミタ。</li><li>デフォルトは `Newline` です。</li><li>利用可能なオプションは `Newline` と `No Delimiter` です。</li></ul> |
| 既存のオブジェクトを上書き | オブジェクトが既に存在する場合、現在のデータで上書きします。チェックが外れている場合、データは追加されます。データを追加する場合、各ブロックはTealiumから転送されるデータを含む単一のオブジェクトの配列で構成されます。 |
| 属性名を印刷 | デフォルトでは、属性キーが使用されます。代わりに属性名をキーとして使用する場合は、このチェックボックスを有効にします。属性名が更新されるとペイロード名が反映されることを考慮してください。 |
| バッチの有効期限 | バッチアクションが送信される頻度を指定するための有効期限（TTL）を構成します。値は `1` から `60` 分の間で入力します。デフォルト値は `10` 分です。 |

### カスタムイベントデータを送信

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| バケット | オブジェクトを作成するバケットを選択します。 |
| オブジェクトパス | データを追加するオブジェクトのパスを指定します。 |

#### メッセージデータ

| **パラメータ** | **説明** |
| --- | --- |
| イベント属性 | イベント属性とベンダーパラメータ間のカスタムマッピングを定義します。 |
| オブジェクトパスサフィックス | ファイルパスに動的なサフィックス（例：タイムスタンプ）を追加する属性を選択します。複数のサフィックス値が提供される場合、それらはアンダースコア文字で区切られます。 |
| レコードサフィックス | <ul><li>各レコードの末尾に追加するサフィックスとしてのデリミタ。</li><li>デフォルトは `Newline` です。</li><li>利用可能なオプションは `Newline` と `No Delimiter` です。</li></ul> |
| 既存のオブジェクトを上書き | オブジェクトが既に存在する場合、現在のデータで上書きします。チェックが外れている場合、データは追加されます。データを追加する場合、各ブロックはTealiumから転送されるデータを含む単一のオブジェクトの配列で構成されます。 |
| テンプレート変数 | <ul><li>**テンプレート**用のデータ入力としてテンプレート変数を提供します。詳細と使用例については、[connector-template-variables](https://docs.tealium.com/connector-template-variables/)を参照してください。</li><li>ドット表記でネストされたテンプレート変数を名前付けします。例：`items.name.`</li><li>ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。</li></ul> |
| テンプレート | <ul><li>メッセージデータで参照されるテンプレートを提供します。詳細については、[about-connector-templates](https://docs.tealium.com/about-connector-templates/)を参照してください。</li><li>テンプレートは、例えば `{{SomeTemplateName}}` のように、サポートされるフィールドに名前で注入されます。</li></ul>|
| バッチの有効期限 | バッチアクションが送信される頻度を指定するための有効期限（TTL）を構成します。値は `1` から `60` 分の間で入力します。デフォルト値は `10` 分です。 |

### すべての訪問データを送信

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| バケット | オブジェクトを作成するバケットを選択します。 |
| オブジェクトパス | データを追加するオブジェクトのパスを指定します。 |
| オブジェクトパスサフィックス | ファイルパスに動的なサフィックス（例：タイムスタンプ）を追加する属性を選択します。複数のサフィックス値が提供される場合、それらはアンダースコア文字で区切られます。 |
| レコードサフィックス | <ul><li>各レコードの末尾に追加するサフィックスとしてのデリミタ。</li><li>デフォルトは `Newline` です。</li><li>利用可能なオプションは `Newline` と `No Delimiter` です。</li></ul> |
| 既存のオブジェクトを上書き | オブジェクトが既に存在する場合、現在のデータで上書きします。チェックが外れている場合、データは追加されます。データを追加する場合、各ブロックはTealiumから転送されるデータを含む単一のオブジェクトの配列で構成されます。 |
| 属性名を印刷 | デフォルトでは、属性キーが使用されます。代わりに属性名をキーとして使用する場合は、このチェックボックスを有効にします。属性名が更新されるとペイロード名が反映されることを考慮してください。 |
| 現在の訪問データを訪問データに含める | このオプションを選択して、現在の訪問データを訪問データに含めます。 |
| バッチの有効期限 | バッチアクションが送信される頻度を指定するための有効期限（TTL）を構成します。値は `1` から `60` 分の間で入力します。デフォルト値は `10` 分です。 |

### カスタム訪問データを送信

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| バケット | オブジェクトを作成するバケットを選択します。 |
| オブジェクトパス | データを追加するオブジェクトのパスを指定します。 |


#### メッセージデータ

| **パラメータ** | **説明** |
| --- | --- |
| オブジェクトパスサフィックス | ファイルパスに動的なサフィックス（例：タイムスタンプ）を追加する属性を選択します。複数のサフィックス値が提供された場合、それらはアンダースコアで区切られます。 |
| レコードサフィックス | <ul><li>各レコードの末尾に追加するサフィックスとしてのデリミタ。</li><li>デフォルトは `Newline` です。</li><li>利用可能なオプションは `Newline` と `No Delimiter` です。</li></ul> |
| 既存のオブジェクトを上書き | オブジェクトが既に存在する場合、現在のデータで上書きします。チェックを外すと、データは追加されます。データを追加する場合、各ブロックはTealiumから転送されたデータを含む単一のオブジェクトの配列で構成されます。 |
| テンプレート変数 | <ul><li>**テンプレート**用のデータ入力としてテンプレート変数を提供します。詳細と使用例については、[connector-template-variables](https://docs.tealium.com/connector-template-variables/)を参照してください。</li><li>ドット表記を使用してネストされたテンプレート変数を命名します。例：`items.name.`</li><li>ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。</li></ul> |
| テンプレート | <ul><li>メッセージデータで参照されるテンプレートを提供します。詳細については、[about-connector-templates](https://docs.tealium.com/about-connector-templates/)を参照してください。</li><li>テンプレートは、例えば `{{SomeTemplateName}}` のように、サポートされるフィールドに名前で二重中括弧を使用して注入されます。</li></ul>|
| バッチの有効期限 | バッチアクションが送信される頻度を指定するための有効期限（TTL）を構成します。`1`から`60`分の間で値を入力します。デフォルト値は `10` 分です。 |

### ログイベントの送信

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| バケット | オブジェクトを作成するバケットを選択します。 |
| オブジェクトパス | データを追加するオブジェクトのパスを指定します。 |

#### メッセージデータ

| **パラメータ** | **説明** |
| --- | --- |
| イベント属性 | イベント属性とベンダーパラメータ間のカスタムマッピングを定義します。 |
| オブジェクトパスサフィックス | ファイルパスに動的なサフィックス（例：タイムスタンプ）を追加する属性を選択します。複数のサフィックス値が提供された場合、それらはアンダースコアで区切られます。 |
| レコードサフィックス | <ul><li>各レコードの末尾に追加するサフィックスとしてのデリミタ。</li><li>デフォルトは `Newline` です。</li><li>利用可能なオプションは `Newline` と `No Delimiter` です。</li></ul> |
| 既存のオブジェクトを上書き | オブジェクトが既に存在する場合、現在のデータで上書きします。チェックを外すと、データは追加されます。データを追加する場合、各ブロックはTealiumから転送されたデータを含む単一のオブジェクトの配列で構成されます。 |
| テンプレート変数 | <ul><li>**テンプレート**用のデータ入力としてテンプレート変数を提供します。詳細と使用例については、[connector-template-variables](https://docs.tealium.com/connector-template-variables/)を参照してください。</li><li>ドット表記を使用してネストされたテンプレート変数を命名します。例：`items.name.`</li><li>ネストされたテンプレート変数は通常、データレイヤーリスト属性から構築されます。</li></ul> |
| テンプレート | <ul><li>メッセージデータで参照されるテンプレートを提供します。詳細については、[about-connector-templates](https://docs.tealium.com/about-connector-templates/)を参照してください。</li><li>テンプレートは、例えば `{{SomeTemplateName}}` のように、サポートされるフィールドに名前で二重中括弧を使用して注入されます。</li></ul>|
| バッチの有効期限 | バッチアクションが送信される頻度を指定するための有効期限（TTL）を構成します。`1`から`60`分の間で値を入力します。デフォルト値は `10` 分です。 |

### ログイベント全体の送信

このベンダーにコネクタエラーログを送信します。詳細については、[connector-error-logging](https://docs.tealium.com/connector-error-logging/)を参照してください。

#### パラメータ

| **パラメータ** | **説明** |
| --- | --- |
| バケット | オブジェクトを作成するバケットを選択します。 |
| オブジェクトパス | データを追加するオブジェクトのパスを指定します。 |
| オブジェクトパスサフィックス | ファイルパスに動的なサフィックス（例：タイムスタンプ）を追加する属性を選択します。複数のサフィックス値が提供された場合、それらはアンダースコアで区切られます。 |
| レコードサフィックス | 各レコードの末尾に使用するデリミタとしてのサフィックスを追加します。改行 (`\n`) またはデリミタなしを選択します。