Method: properties.audienceLists.create

تنشئ قائمة مستخدمين لاستردادها لاحقًا. تعرض هذه الطريقة اسم مورد قائمة المستخدمين بسرعة وتبدأ طلبًا غير متزامن طويل الأمد لتكوين قائمة مستخدمين. لإدراج المستخدمين في قائمة مستخدمين، عليك أولاً إنشاء قائمة المستخدمين من خلال هذه الطريقة، ثم إرسال اسم مورد الجمهور إلى طريقة audienceLists.query.

راجِع إنشاء قائمة مستخدمين للحصول على مقدمة عن قوائم المستخدمين مع أمثلة.

قائمة المستخدِمين هي نبذة عن المستخدِمين المُدرَجين حاليًا في شريحة الجمهور في وقت إنشاء قائمة المستخدِمين. سيؤدي إنشاء قوائم مستخدمين واحدة لجمهور واحد في أيام مختلفة إلى عرض نتائج مختلفة عند دخول المستخدمين إلى الجمهور وخروجهم منه.

تسمح لك شرائح الجمهور في "إحصاءات Google 4" بتقسيم المستخدِمين بالطرق المهمة لنشاطك التجاري. لمعرفة المزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/analytics/answer/9267572. تحتوي قوائم المستخدمين على المستخدمين في كل شريحة جمهور.

تتوفّر هذه الطريقة في الإصدار التجريبي من الثبات على الرابط audienceExports.create. لتقديم ملاحظاتك حول واجهة برمجة التطبيقات هذه، يُرجى إكمال نموذج ملاحظات حول Audience Export API في "إحصاءات Google".

طلب HTTP

POST https://analyticsdata.googleapis.com/v1alpha/{parent=properties/*}/audienceLists

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
parent

string

مطلوبة. هو المورد الرئيسي الذي سيتم إنشاء قائمة المستخدمين هذه من خلاله. تنسيق الملف: properties/{property}

نص الطلب

يحتوي نص الطلب على مثال AudienceList.

نص الاستجابة

إذا كانت الاستجابة ناجحة، يحتوي نص الاستجابة على مثيل Operation تم إنشاؤه حديثًا.

نطاقات التفويض

يتطلب استخدام أحد نطاقات OAuth التالية:

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