Method: accounts.freeBookingLinksReportViews.query

تم إيقافها نهائيًا: استخدِم PropertyPerformanceReportService.QueryPropertyPerformanceReport بدلاً من ذلك، إذ تتضمّن هذه السمة أيضًا إعداد تقارير عن مرات الظهور. تتيح إمكانية طلب (الحصول على تقرير روابط الحجز المجانية وفلترته وتقسيمه) لحساب معيّن.

طلب HTTP

GET https://travelpartner.googleapis.com/v3/{name=accounts/*}/freeBookingLinksReportViews:query

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

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

المعلمات
name

string

اسم مورد الحساب الذي يتمّ طلب البحث عنه. التنسيق: accounts/{account_id}

مَعلمات طلب البحث

المعلمات
filter

string

الشروط (الحقول والعبارات) المستخدَمة لفلترة مقاييس رابط الحجز المجاني للحساب الذي يتم الاستعلام عنه تتطلّب بنية الجملة مسافات تحيط بالعامل in. وفي ما عدا ذلك، يمكن حذف المسافات. يمكن دمج الشروط باستخدام عامل التشغيل and.

يجب ملء حقل date. جميع الحقول الأخرى اختيارية.

تكون قيم الحقل date شاملة ويجب أن تكون بالتنسيق YYYY-MM-DD. أول تاريخ مقبول هو 2021-03-09، وسيتم تحويل قيم التاريخ السابقة إلى 2021-03-09.

تتم مطابقة قيم partnerHotelDisplayName بدون مراعاة حالة الأحرف.

في ما يلي أمثلة على الشروط الصالحة:

  • date = '2021-12-03'
  • date between '2021-12-03' and '2021-12-08'
  • deviceType = 'TABLET'
  • deviceType in ('MOBILE', 'TABLET')
  • partnerHotelId = 'AAA'
  • partnerHotelId in ('AAA', 'BBB')
  • partnerHotelDisplayName = 'hotel A'
  • partnerHotelDisplayName in ('Hotel A', 'HOTEL b')
  • userRegionCode = 'US'
  • userRegionCode in ('US', 'CA')
aggregateBy

string

تحدّد هذه السمة كيفية تقسيم المقاييس التي يعرضها طلب البحث. على سبيل المثال، إذا تم تحديد userRegionCode، ستوفّر freeBookingLinksResult مقاييس مجمّعة حسب منطقة المستخدم.

قيمة السلسلة هي قائمة حقول مفصولة بفواصل. الحقول الصالحة هي: date وuserRegionCode وdeviceType وpartnerHotelId وpartnerHotelDisplayName. يتم تضمين الحقول المحدّدة هنا فقط في FreeBookingLinksResult.
pageSize

integer

الحد الأقصى لعدد نتائج المشاركة التي سيتم عرضها قد تعرض الخدمة عددًا أقل من هذه القيمة. إذا لم يتم تحديدها، سيتم عرض 10,000 نتيجة كحدّ أقصى. الحد الأقصى للقيمة هو 10,000، وسيتم فرض القيمة 10,000 على القيم الأكبر من 10,000.
pageToken

string

رمز مميّز للصفحة تم تلقّيه من طلب سابق من طلبات participationReportViews.query. يجب تقديم هذا الرمز لتلقّي الصفحة التالية.

عند تقسيم النتائج إلى صفحات، يجب أن تتطابق جميع المَعلمات الأخرى المقدَّمة إلى participationReportViews.query مع الطلب الذي قدّم رمز الصفحة المميّز.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

تم إيقافها نهائيًا: استخدِم QueryPropertyPerformanceReportResponse مع PropertyPerformanceReportService بدلاً من ذلك. رسالة الردّ على FreeBookingLinksReportService.QueryFreeBookingLinksReport

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

تمثيل JSON 
{
  "results": [
    {
      object (FreeBookingLinksResult)
    }
  ],
  "nextPageToken": string
}
الحقول
results[]

object (FreeBookingLinksResult)

قائمة النتائج المطابقة لطلب البحث
nextPageToken

string

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

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

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/travelpartner

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

FreeBookingLinksResult

تم إيقافها نهائيًا: استخدِم PropertyPerformanceResult مع PropertyPerformanceReportService بدلاً من ذلك. تمثّل هذه السمة نتيجة طلب البحث عن إحصاءات الروابط المجانية للحجز الخاصة بحساب معيّن.

تمثيل JSON 
{
  "date": {
    object (Date)
  },
  "userRegionCode": string,
  "deviceType": enum (Device),
  "partnerHotelId": string,
  "partnerHotelDisplayName": string,
  "clickCount": string
}
الحقول
date

object (Date)

تاريخ ضمن النطاق الزمني المطلوب

يتم عرضها فقط إذا تم تحديد date في aggregateBy في الطلب.
userRegionCode

string

تمثّل هذه السمة رمز المنطقة وفقًا لمعيار ISO 3116 الخاص ببلد المستخدِم أو منطقته.

لا تظهر إلا إذا تم تحديد userRegionCode في aggregateBy في الطلب
deviceType

enum (Device)

نوع جهاز المستخدم

يتم عرضها فقط إذا تم تحديد deviceType في aggregateBy في الطلب.
partnerHotelId

string

رقم تعريف الفندق الشريك

يتم عرضها فقط إذا تم تحديد partnerHotelId في aggregateBy في الطلب.
partnerHotelDisplayName

string

اسم الفندق الخاص بالشريك

يتم عرضها فقط إذا تم تحديد partnerHotelDisplayName في aggregateBy في الطلب.
clickCount

string (int64 format)

تمثّل هذه السمة إجمالي عدد النقرات التي تم تسجيلها لهذه النتيجة.