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

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