Method: properties.audienceLists.create

فهرست مخاطبان را برای بازیابی بعدی ایجاد می کند. این روش به سرعت نام منبع فهرست مخاطبان را برمی گرداند و یک درخواست ناهمزمان طولانی را برای تشکیل لیست مخاطبان آغاز می کند. برای قرار دادن کاربران در فهرست مخاطبان، ابتدا فهرست مخاطبان را از این روش ایجاد کنید و سپس نام منبع مخاطب را به روش audienceLists.query ارسال کنید.

برای آشنایی با فهرست مخاطبان همراه با مثال، به ایجاد فهرست مخاطبان مراجعه کنید.

فهرست مخاطبان تصویری از کاربرانی است که در حال حاضر در زمان ایجاد فهرست مخاطبان در بین مخاطبان حضور دارند. ایجاد فهرست مخاطبان برای یک مخاطب در روزهای مختلف نتایج متفاوتی را با ورود و خروج کاربران به مخاطبان به همراه خواهد داشت.

مخاطبان در Google Analytics 4 به شما این امکان را می دهند که کاربران خود را به روش هایی که برای کسب و کار شما مهم هستند تقسیم بندی کنید. برای کسب اطلاعات بیشتر، به https://support.google.com/analytics/answer/9267572 مراجعه کنید. فهرست مخاطبان شامل کاربران هر مخاطب است.

این روش در ثبات بتا در audienceExports.create موجود است. برای ارائه بازخورد خود در مورد این API، فرم بازخورد Google Analytics 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.readonly
  • https://www.googleapis.com/auth/analytics