يسترجع تقريرًا محدّدًا من خلال طلب بحث. قد يحتوي الردّ على صفوف أقلّ من تلك المحدّدة في pageSize
. استخدِم nextPageToken
لتحديد ما إذا كان هناك المزيد من الصفوف المطلوب طلبها.
طلب HTTP
POST https://merchantapi.googleapis.com/reports/v1beta/{parent=accounts/*}/reports:search
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات | |
---|---|
parent |
مطلوب. رقم تعريف الحساب الذي يجري المكالمة يجب أن يكون حسابًا مستقلاً أو حسابًا فرعيًا لحساب متعدّد العملاء. التنسيق: accounts/{account} |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "query": string, "pageSize": integer, "pageToken": string } |
الحقول | |
---|---|
query |
مطلوب. طلب بحث يحدِّد التقرير المطلوب استرجاعه لمعرفة تفاصيل عن كيفية إنشاء طلب البحث، اطّلِع على دليل لغة طلبات البحث. للحصول على القائمة الكاملة للجداول والحقول المتاحة، اطّلِع على "الحقول المتاحة". |
page |
اختيارية: عدد |
page |
اختيارية: الرمز المميّز للصفحة المطلوب استردادها إذا لم يتم تحديدها، يتم عرض الصفحة الأولى من النتائج. لطلب الصفحة التالية من النتائج، يجب استخدام القيمة التي تم الحصول عليها من |
نص الاستجابة
رسالة الردّ لطريقة ReportService.Search
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"results": [
{
object ( |
الحقول | |
---|---|
results[] |
الصفوف التي تطابقت مع طلب البحث |
next |
رمز مميّز يمكن إرساله على شكل |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/content
لمزيد من المعلومات، يُرجى الاطّلاع على نظرة عامة على بروتوكول OAuth 2.0.