- طلب HTTP
- مَعلمات المسار
- نص الطلب
- نص الاستجابة
- نطاقات التفويض
- AudienceRow
- AudienceDimensionValue
- جرِّبه الآن
لاسترداد تصدير بيانات الجمهور من المستخدمين. بعد إنشاء شريحة جمهور، لا يكون المستخدمون متاحين للتصدير على الفور. أولاً، من الضروري إرسال طلب إلى "audienceExports.create
" لإنشاء عملية تصدير لشرائح الجمهور، ثم ثانيًا، تُستخدَم هذه الطريقة لاسترداد المستخدِمين في عملية تصدير شرائح الجمهور.
اطّلِع على إنشاء تصدير بيانات الجمهور للحصول على مقدمة عن عمليات تصدير شرائح الجمهور مع أمثلة.
تسمح لك شرائح الجمهور في "إحصاءات Google 4" بتقسيم المستخدِمين بالطرق المهمة لنشاطك التجاري. لمعرفة المزيد من المعلومات، يُرجى الاطّلاع على https://support.google.com/analytics/answer/9267572.
تحتوي واجهات برمجة تطبيقات Audience Export API على بعض الطرق في الإصدار الأولي وطرق أخرى بالاستقرار التجريبي. الهدف من ذلك هو تطوير طرق لاستقرار الإصدار التجريبي بعد الحصول على بعض الملاحظات والاعتماد. لتقديم ملاحظاتك حول واجهة برمجة التطبيقات هذه، يُرجى إكمال نموذج ملاحظات حول Audience Export API في "إحصاءات Google".
طلب HTTP
POST https://analyticsdata.googleapis.com/v1beta/{name=properties/*/audienceExports/*}:query
يستخدم عنوان URL بنية تحويل الترميز gRPC.
معلمات المسار
المَعلمات | |
---|---|
name |
مطلوبة. اسم شريحة الجمهور التي يتم تصدير بياناتها لاسترداد المستخدمين منها. تنسيق الملف: |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "offset": string, "limit": string } |
الحقول | |
---|---|
offset |
اختياريّ. عدد الصفوف في صف البداية. يتم احتساب الصف الأول على أنه الصف 0. عند إجراء التقسيم على صفحات، لا يحدد الطلب الأول الإزاحة، أو ما يعادله، يعمل على ضبط الإزاحة على 0، يعرض الطلب الأول أول لمزيد من المعلومات عن مَعلمة التقسيم على صفحات هذه، اطّلِع على تقسيم النتائج على عدّة صفحات. |
limit |
اختياريّ. عدد الصفوف المطلوب عرضها. وفي حال عدم تحديد قيمة، يتم عرض 10,000 صف. تعرض واجهة برمجة التطبيقات 250,000 صف كحد أقصى لكل طلب، بغض النظر عن العدد الذي تطلبه. يجب أن تكون قيمة الحقل " ويمكن أن تعرِض واجهة برمجة التطبيقات أيضًا صفوفًا أقل من قيمة لمزيد من المعلومات عن مَعلمة التقسيم على صفحات هذه، اطّلِع على تقسيم النتائج على عدّة صفحات. |
نص الاستجابة
قائمة بالمستخدمين في عملية تصدير شريحة جمهور.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "audienceRows": [ { object ( |
الحقول | |
---|---|
audienceRows[] |
صفوف لكلّ مستخدِم في عملية تصدير شريحة جمهور. سيكون عدد الصفوف في هذه الاستجابة أقل من حجم صفحة الطلب أو مساويًا له. |
audienceExport |
بيانات الإعدادات المتعلّقة بالاستعلام عن AudienceExport تم عرضه للمساعدة في تفسير صفوف الجمهور في هذا الرد. على سبيل المثال، تتطابق السمات في AudienceExport هذا مع الأعمدة في AudienceRows. |
rowCount |
إجمالي عدد الصفوف في نتيجة AudienceExport. وتكون لمزيد من المعلومات عن مَعلمة التقسيم على صفحات هذه، اطّلِع على تقسيم النتائج على عدّة صفحات. |
نطاقات التفويض
يتطلب استخدام أحد نطاقات OAuth التالية:
https://www.googleapis.com/auth/analytics.readonly
https://www.googleapis.com/auth/analytics
AudienceRow
سمات قيمة السمة لصف مستخدم الجمهور.
تمثيل JSON |
---|
{
"dimensionValues": [
{
object ( |
الحقول | |
---|---|
dimensionValues[] |
كل سمة لقيمة السمة لمستخدِم من الجمهور. ستتم إضافة قيمة سمة واحدة لكل عمود سمة مطلوب. |
AudienceDimensionValue
قيمة السمة.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد one_value أحد أنواع قيمة البُعد. يمكن أن يكون الحقل "one_value " واحدًا فقط مما يلي: |
|
value |
القيمة كسلسلة إذا كان نوع السمة عبارة عن سلسلة. |