Method: properties.recurringAudienceLists.create
یک لیست مخاطبان تکراری ایجاد می کند. لیست مخاطبان تکراری هر روز لیست مخاطبان جدیدی تولید می کند. فهرست مخاطبان، کاربرانی هستند که در زمان ایجاد لیست در یک مخاطب قرار دارند.
فهرست مخاطبان مکرر تضمین میکند که فهرست مخاطبان را بر اساس جدیدترین دادههای موجود برای استفاده هر روز دارید. اگر فهرست مخاطبان را به صورت دستی ایجاد کنید، نمیدانید چه زمانی فهرست مخاطبان براساس دادههای یک روز اضافی در دسترس است. این فهرست مخاطبان تکراری، زمانی که دادههای یک روز اضافی در دسترس باشد، فهرست مخاطبان را بهطور خودکار ایجاد میکند. با استفاده از فهرست مخاطبان مکرر در مقابل ایجاد دستی فهرست مخاطبان در زمانهای مختلف روز و تلاش برای حدس زدن اینکه چه زمانی دادههای یک روز دیگر آماده است، توکنهای سهمیه کمتری مصرف خواهید کرد.
این روش در ثبات آلفا با هدف جمعآوری بازخورد در نحو و قابلیتها قبل از ورود به بتا معرفی شده است. برای ارائه بازخورد خود در مورد این API، فرم بازخورد Google Analytics Audience Export API را تکمیل کنید.
درخواست HTTP
POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های |
---|
parent | string ضروری. منبع والد که این لیست مخاطب تکراری در آن ایجاد خواهد شد. قالب: properties/{property} |
درخواست بدن
بدنه درخواست شامل یک نمونه از RecurringAudienceList
است.
بدن پاسخگو
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی یک نمونه جدید از RecurringAudienceList
است.
محدوده مجوز
به یکی از حوزه های OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/analytics.readonly
-
https://www.googleapis.com/auth/analytics
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2024-10-25 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2024-10-25 بهوقت ساعت هماهنگ جهانی."],[[["Creates recurring audience lists daily, ensuring the most recent data is available for use."],["Automates audience list creation, reducing manual effort and quota token consumption."],["Introduced at alpha stability, seeking feedback through a provided form."],["Uses an HTTP POST request to create recurring audience lists under a specified property."],["Requires specific OAuth scopes for authorization."]]],["This content details how to create a recurring audience list via an API. Key actions include sending a `POST` request to a specific URL (`https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/recurringAudienceLists`). The request requires a `parent` path parameter indicating the property. The request body contains the `RecurringAudienceList` instance, and upon success, the response body returns a newly created `RecurringAudienceList`. This automated list generation uses less quota and ensures the use of the most recent data available. The use of certain authorization scopes are required.\n"]]