همه فهرستهای تکراری مخاطبان یک ملک را فهرست میکند. از این روش میتوان برای یافتن و استفاده مجدد از فهرستهای مخاطبان مکرر موجود به جای ایجاد فهرستهای تکراری جدید غیرضروری استفاده کرد. یک مخاطب میتواند چندین فهرست مخاطب تکرار شونده داشته باشد که ترکیبهای ابعاد مختلف را نشان میدهد. برای مثال، فقط بعد deviceId یا هر دو ابعاد deviceId و userId .
این روش در ثبات آلفا با هدف جمعآوری بازخورد در نحو و قابلیتها قبل از ورود به بتا معرفی شده است. برای ارائه بازخورد خود در مورد این API، فرم بازخورد Google Analytics Audience Export API را تکمیل کنید.
درخواست HTTP
GET https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists
مورد نیاز. همه فهرستهای تکراری مخاطبین برای این ویژگی در پاسخ فهرست میشوند. فرمت: properties/{property}
پارامترهای پرس و جو
پارامترها
page Size
integer
اختیاری. حداکثر تعداد فهرست مخاطبان تکراری برای بازگشت. این سرویس ممکن است کمتر از این مقدار را بازگرداند. اگر نامشخص باشد، حداکثر 200 لیست مخاطب تکراری بازگردانده می شود. حداکثر مقدار 1000 است (مقادیر بالاتر به حداکثر اعمال می شود).
page Token
string
اختیاری. یک نشانه صفحه، دریافت شده از یک تماس recurringAudienceLists.list قبلیAudienceLists.list. این را برای بازیابی صفحه بعدی ارائه کنید.
هنگام صفحه بندی، تمام پارامترهای دیگر ارائه شده به recurringAudienceLists.list باید با فراخوانی که نشانه صفحه را ارائه می کند مطابقت داشته باشد.
درخواست بدن
بدنه درخواست باید خالی باشد.
بدن پاسخگو
لیستی از تمام لیست های مخاطبان تکراری برای یک ملک.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eLists all recurring audience lists for a given Google Analytics property, allowing for reuse of existing lists.\u003c/p\u003e\n"],["\u003cp\u003eEnables finding audience lists with different dimension combinations (e.g., deviceId, userId).\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination to retrieve large numbers of recurring audience lists.\u003c/p\u003e\n"],["\u003cp\u003eRequires specific authorization scopes for access.\u003c/p\u003e\n"],["\u003cp\u003eCurrently in alpha, with a feedback form available for user input.\u003c/p\u003e\n"]]],["This document details how to list recurring audience lists for a property using the Google Analytics Audience Export API. The API uses a `GET` request to a specified URL with the property ID as a path parameter. Optional query parameters (`pageSize`, `pageToken`) manage pagination. The request body is empty. The response is a JSON object containing an array of recurring audience lists and a `nextPageToken` for further pagination, if required. Authorization requires specific OAuth scopes.\n"],null,[]]