Method: properties.audienceLists.create
後で取得できるようにオーディエンス リストを作成します。このメソッドは、オーディエンス リストのリソース名をすばやく返し、長時間実行される非同期リクエストを開始して、オーディエンス リストを作成します。オーディエンス リストのユーザーを一覧表示するには、まずこのメソッドでオーディエンス リストを作成してから、オーディエンス リソース名を audienceLists.query メソッドに送信します。
オーディエンス リストの概要と例については、オーディエンス リストを作成するをご覧ください。
オーディエンス リストとは、オーディエンス リストの作成時に、そのオーディエンスに現在含まれているユーザーのスナップショットです。1 つのオーディエンスに対して日ごとにオーディエンス リストを作成すると、そのオーディエンスへの参加と離脱によって結果が異なります。
Google アナリティクス 4 のオーディエンスを使用すると、ビジネスの目的に合わせてユーザーをセグメント化できます。詳しくは、https://support.google.com/analytics/answer/9267572 をご覧ください。オーディエンス リストには、各オーディエンスのユーザーが含まれます。
このメソッドは、audienceExports.create でベータ版の安定版として利用できます。この API に関するフィードバックは、Google アナリティクス Audience Export API フィードバック フォームにご記入ください。
HTTP リクエスト
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists
この URL は gRPC Transcoding 構文を使用します。
パスパラメータ
| パラメータ |
parent |
string
必須。このオーディエンス リストが作成される親リソース。形式: properties/{property}
|
リクエスト本文
リクエストの本文には AudienceList のインスタンスが含まれています。
レスポンスの本文
成功した場合、レスポンスの本文には、新しく作成された Operation のインスタンスが含まれます。
承認スコープ
次の OAuth スコープのいずれかが必要です。
https://www.googleapis.com/auth/analytics.readonlyhttps://www.googleapis.com/auth/analytics
特に記載のない限り、このページのコンテンツはクリエイティブ・コモンズの表示 4.0 ライセンスにより使用許諾されます。コードサンプルは Apache 2.0 ライセンスにより使用許諾されます。詳しくは、Google Developers サイトのポリシーをご覧ください。Java は Oracle および関連会社の登録商標です。
最終更新日 2024-05-02 UTC。
[null,null,["最終更新日 2024-05-02 UTC。"],[[["Creates an audience list containing a snapshot of users in an audience at the time of creation, allowing for later retrieval and querying."],["The method utilizes an asynchronous request, returning the audience list resource name immediately while the list formation process occurs in the background."],["Audience lists are dynamic and reflect the current state of an audience; creating lists on different days for the same audience may yield varied results due to user fluctuations."],["Utilizes the `audienceExports.create` method at beta stability, requiring specific authorization scopes for access."]]],["This API method facilitates the creation of audience lists in Google Analytics 4. It initiates an asynchronous process to generate a list of users matching a defined audience. Key actions include sending a POST request to `audienceLists` with a defined `parent` path parameter, representing the property. The request body defines the audience list, and the successful response includes the audience list's resource name and an Operation instance. Authorization requires specific OAuth scopes. The newly created list can then be used for user segmentation.\n"]]
