Method: accounts.freeBookingLinksReportViews.query

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

طلب HTTP

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

يستخدم عنوان URL بنية gRPC Transcoding.

معلّمات المسار

المَعلمات
name

string

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

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

المَعلمات
filter

string

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

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

قيم الحقل date شاملة، ويجب أن تكون بتنسيق يوم/شهر/سنة. أقرب تاريخ مقبول هو 2021-03-09. سيتم فرض قيم التاريخ السابق في 09-2021.

تتم مطابقة قيم 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. لا يتم تضمين سوى الحقول المحددة هنا في FreeBookingLinksالنتيجة.
pageSize

integer

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

string

رمز مميز للصفحة، تم استلامه من طلب مشارك سابق في ReportViews.query. قدِّم هذا العنوان لاستلام الصفحة التالية.

عند التقسيم على صفحات، يجب أن تتطابق جميع المعلّمات الأخرى المقدَّمة إلى reviewReports.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.

نتيجة FreeBookingLinks

متوقف: يمكنك استخدام 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)

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