نعمل حاليًا على نقل مجموعة فرعية من أنواع التقارير من التقارير بلا إنترنت إلى التقارير الفورية. بعد نقل بيانات المستخدِم، ستتضمّن ردود
queries.list
تقارير فورية حالية. ويمكنك الاطّلاع على
مشاركة المدونة للحصول على مزيد من المعلومات.
Queries: runquery
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
ينفّذ طلب بحث مخزّنًا لإنشاء تقرير.
تجربة ذلك الآن
الطلب
طلب HTTP
POST https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId
المعلمات
اسم المعلَمة |
القيمة |
الوصف |
مَعلمات المسار |
queryId |
long |
رقم تعريف طلب البحث المطلوب تنفيذه.
|
مَعلمات طلب البحث الاختيارية |
asynchronous |
boolean |
لتحديد ما إذا كان يجب تنفيذ طلب البحث بشكل غير متزامن أم لا. عندما تكون true، تكون هذه الطريقة
على الفور. عند تحديد القيمة false أو عدم تحديدها، لن يتم
حتى يتم الانتهاء من تشغيل الاستعلام.
(القيمة التلقائية: false )
|
التفويض
يتطلب هذا الطلب تفويضًا بالنطاق التالي:
النطاق |
https://www.googleapis.com/auth/doubleclickbidmanager |
لمزيد من المعلومات، يُرجى الاطّلاع على صفحة المصادقة والتفويض.
نص الطلب
في نص الطلب، وفِّر البيانات بالبنية التالية:
{
"dataRange": string,
"reportDataStartTimeMs": long,
"reportDataEndTimeMs": long,
"timezoneCode": string
}
اسم الموقع |
القيمة |
الوصف |
ملاحظات |
dataRange |
string |
نطاق بيانات التقرير المستخدَم لإنشاء التقرير.
في ما يلي القيم المقبولة:
- "
ALL_TIME "
- "
CURRENT_DAY "
- "
CUSTOM_DATES "
- "
LAST_14_DAYS "
- "
LAST_30_DAYS "
- "
LAST_365_DAYS "
- "
LAST_60_DAYS "
- "
LAST_7_DAYS "
- "
LAST_90_DAYS "
- "
MONTH_TO_DATE "
- "
PREVIOUS_DAY "
- "
PREVIOUS_HALF_MONTH "
- "
PREVIOUS_MONTH "
- "
PREVIOUS_QUARTER "
- "
PREVIOUS_WEEK "
- "
PREVIOUS_YEAR "
- "
QUARTER_TO_DATE "
- "
TYPE_NOT_SUPPORTED "
- "
WEEK_TO_DATE "
- "
YEAR_TO_DATE "
|
|
reportDataStartTimeMs |
long |
وقت بدء البيانات التي تظهر في التقرير. ملاحظة: يجب توفير السمة reportDataStartTimeMs إذا كانت قيمة السمة dataRange هي CUSTOM_DATES ويتم تجاهلها في الحالات الأخرى. |
|
reportDataEndTimeMs |
long |
وقت انتهاء البيانات التي تظهر في التقرير. ملاحظة: يجب توفير السمة reportDataEndTimeMs إذا كانت قيمة السمة dataRange هي CUSTOM_DATES ويتم تجاهلها في الحالات الأخرى. |
|
timezoneCode |
string |
رمز المنطقة الزمنية الأساسية لوقت بيانات التقرير. وتكون القيمة التلقائية هي America/New_York . |
|
الرد
في حال نجاح هذه الطريقة، سيتم عرض نص استجابة فارغ.
جرّب الآن
يمكنك استخدام "مستكشف واجهات برمجة التطبيقات" أدناه لطلب هذه الطريقة على البيانات المباشرة والاطّلاع على الردّ.
ويمكنك بدلاً من ذلك تجربة
مستقل
Explorer (المستكشف):
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2024-08-22 (حسب التوقيت العالمي المتفَّق عليه)"],[[["This version of the Bid Manager API is sunset, and users should migrate to Bid Manager API v2."],["Requests to this version may return errors, and specific fields in retrieved `Query` resources will be empty."],["The `runquery` request runs a stored query to generate a report, accepting parameters like `queryId`, `asynchronous`, `dataRange`, and time parameters."],["Authorization with the `https://www.googleapis.com/auth/doubleclickbidmanager` scope is required for this request."]]],["The Bid Manager API v1.1 is sunset; users must migrate to v2. Requests to v1.1 may error, and successful requests will return empty `metadata.googleCloudStoragePathForLatestReport`, `metadata.latestReportRunTimeMs`, and `metadata.googleDrivePathForLatestReport` fields. To run a query, send a POST request with the `queryId`, optional asynchronous parameter, and report data range, start/end times, and timezone in the request body. This requires authorization with the `doubleclickbidmanager` scope.\n"]]