Method: properties.recurringAudienceLists.list

همه فهرست‌های تکراری مخاطبان یک ملک را فهرست می‌کند. از این روش می‌توان برای یافتن و استفاده مجدد از فهرست‌های مخاطبان مکرر موجود به جای ایجاد فهرست‌های تکراری جدید غیرضروری استفاده کرد. یک مخاطب می‌تواند چندین فهرست مخاطب تکرار شونده داشته باشد که ترکیب‌های ابعاد مختلف را نشان می‌دهد. برای مثال، فقط بعد deviceId یا هر دو ابعاد deviceId و userId .

این روش در ثبات آلفا با هدف جمع‌آوری بازخورد در نحو و قابلیت‌ها قبل از ورود به بتا معرفی شده است. برای ارائه بازخورد خود در مورد این API، فرم بازخورد Google Analytics Audience Export API را تکمیل کنید.

درخواست HTTP

GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
parent

string

ضروری. همه فهرست‌های تکراری مخاطبین برای این ویژگی در پاسخ فهرست می‌شوند. فرمت: properties/{property}

پارامترهای پرس و جو

مولفه های
pageSize

integer

اختیاری. حداکثر تعداد فهرست مخاطبان تکراری برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند. اگر نامشخص باشد، حداکثر 200 لیست مخاطب تکراری بازگردانده می شود. حداکثر مقدار 1000 است (مقادیر بالاتر به حداکثر اعمال می شود).

pageToken

string

اختیاری. یک نشانه صفحه، دریافت شده از یک تماس recurringAudienceLists.list قبلیAudienceLists.list. این را برای بازیابی صفحه بعدی ارائه کنید.

هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به recurringAudienceLists.list باید با فراخوانی که نشانه صفحه را ارائه می کند مطابقت داشته باشد.

درخواست بدن

بدنه درخواست باید خالی باشد.

بدن پاسخگو

لیستی از تمام لیست های مخاطبان تکراری برای یک ملک.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "recurringAudienceLists": [
    {
      object (RecurringAudienceList)
    }
  ],
  "nextPageToken": string
}
زمینه های
recurringAudienceLists[]

object ( RecurringAudienceList )

هر فهرست مخاطب تکراری برای یک ملک.

nextPageToken

string

یک نشانه، که می تواند به عنوان pageToken برای بازیابی صفحه بعدی ارسال شود. اگر این قسمت حذف شود، هیچ صفحه بعدی وجود ندارد.

محدوده مجوز

به یکی از حوزه های OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics