Method: properties.audienceExports.query

يسترد شرائح الجمهور التي تم تصديرها للمستخدمين. بعد إنشاء شريحة جمهور، لن يكون المستخدمون متاحين للتصدير على الفور. أولاً، من الضروري إرسال طلب إلى 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

string

مطلوب. اسم عملية تصدير شريحة الجمهور التي يتم استرداد المستخدِمين منها تنسيق الملف: properties/{property}/audienceExports/{audienceExport}

نص الطلب

يحتوي نص الطلب على بيانات بالبنية التالية:

تمثيل JSON 
{
  "offset": string,
  "limit": string
}
الحقول
offset

string (int64 format)

اختياريّ. عدد صفوف صف البداية. يتم احتساب الصف الأول على أنه الصف 0.

عند الترحيل، لا يحدد الطلب الأول الإزاحة؛ أو ما يعادل ذلك، يتم تعيينها على 0؛ يعرض الطلب الأول أول limit من الصفوف. ويحدّد الطلب الثاني معادلة لقيمة limit للطلب الأول، فإن الطلب الثاني يُرجع limit الثانية من الصفوف.

لمزيد من المعلومات عن مَعلمة تقسيم النتائج على صفحات، يمكنك الاطّلاع على مقالة التقسيم على صفحات.
limit

string (int64 format)

اختياريّ. عدد الصفوف المطلوب عرضها. في حال عدم تحديد قيمة الحقل، سيتم عرض 10,000 صف. تعرض واجهة برمجة التطبيقات 250,000 صف كحدٍ أقصى لكل طلب، بغض النظر عن عدد الصفوف التي تطلبها. يجب أن تكون قيمة limit موجبة.

ويمكن أن تعرض واجهة برمجة التطبيقات أيضًا صفوفًا أقل من قيمة limit المطلوبة، إذا لم يتوفّر عدد قيم السمات مثل limit.

لمزيد من المعلومات عن مَعلمة تقسيم النتائج على صفحات، يمكنك الاطّلاع على مقالة التقسيم على صفحات.

نص الاستجابة

قائمة بالمستخدمين في عملية تصدير شرائح جمهور

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "audienceRows": [
    {
      object (AudienceRow)
    }
  ],
  "audienceExport": {
    object (AudienceExport)
  },
  "rowCount": integer
}
الحقول
audienceRows[]

object (AudienceRow)

صفوف لكل مستخدم في عملية تصدير شريحة جمهور. سيكون عدد الصفوف في هذه الاستجابة أقل من حجم صفحة الطلب أو مساويًا له.
audienceExport

object (AudienceExport)

بيانات الإعدادات التي يتم الاستعلام عنها بشأن AudienceExport. تم الرجوع للمساعدة في تفسير صفوف الجمهور في هذه الاستجابة. على سبيل المثال، تتطابق السمات في AudienceExport هذه مع الأعمدة في AudienceRows.
rowCount

integer

إجمالي عدد الصفوف في نتيجة AudienceExport. rowCount مستقلة عن عدد الصفوف التي يتم عرضها في الاستجابة ومعلمة طلب limit ومعلمة طلب offset. على سبيل المثال، إذا كان طلب البحث يعرض 175 صفًا ويتضمّن limit من 50 في طلب البيانات من واجهة برمجة التطبيقات، سيتضمّن الردّ rowCount من 175 صفًا ولكن 50 صفًا فقط.

لمزيد من المعلومات عن مَعلمة تقسيم النتائج على صفحات، يمكنك الاطّلاع على مقالة التقسيم على صفحات.

نطاقات الأذونات

يتطلب هذا الإعداد أحد نطاقات OAuth التالية:

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

AudienceRow

سمات قيم البُعد لصف مستخدِم الجمهور

تمثيل JSON 
{
  "dimensionValues": [
    {
      object (AudienceDimensionValue)
    }
  ]
}
الحقول
dimensionValues[]

object (AudienceDimensionValue)

كل سمة من سمات قيمة السمة لمستخدم شريحة جمهور. ستتم إضافة قيمة سمة واحدة لكل عمود سمة مطلوب.

AudienceDimensionValue

قيمة السمة.

تمثيل JSON 
{

  // Union field one_value can be only one of the following:
  "value": string
  // End of list of possible types for union field one_value.
}
الحقول
حقل الاتحاد one_value. نوع واحد من قيمة البُعد. يمكن أن يكون one_value واحدًا فقط مما يلي:
value

string

القيمة كسلسلة إذا كان نوع السمة سلسلة.