Method: exchanges.auctionPackages.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
طلب HTTP
GET https://dv360seller.googleapis.com/v1beta1/{parent=exchanges/*}/auctionPackages
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المعلمات |
parent |
string
اسم المورد الرئيسي مثال: "exchanges/123". مطلوب.
|
مَعلمات طلب البحث
المعلمات |
pageSize |
integer
الحد الأقصى لعدد العناصر التي سيتم عرضها الحد الأقصى المسموح به هو 50. إذا لم يتم تحديد عدد صفحات أو إذا كان العدد أكبر من 50، سيتم استخدام 50 كحجم الصفحة.
|
pageToken |
string
قيمة nextPageToken التي تم إرجاعها من طلب List سابق، إن توفّر.
|
filter |
string
السماح بالفلترة حسب المواقع بنية الجملة المتوافقة:
- تتألّف عبارات الفلاتر من قيد واحد أو أكثر.
- يمكن دمج القيود باستخدام عاملَي التشغيل المنطقيَين
AND أو OR . تستخدم تسلسل القيود AND بشكل ضمني.
- يكون التنسيق الخاص بالقيود على النحو التالي:
<field> <operator> <value> .
- يجب أن يكون المشغّل
EQUALS (=) .
- الحقول المتاحة حاليًا:
أمثلة:
- الحصول على حزم المزادات التي تم ضبط externalDealId فيها على "package-1234"
externalDealId="package-1234"
يجب ألا يزيد طول هذا الحقل عن 500 حرف.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
ردّ على طلب إدراج حِزم المزاد
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
{
"auctionPackage": [
{
object (AuctionPackage )
}
],
"nextPageToken": string
} |
الحقول |
auctionPackage[] |
object (AuctionPackage )
حزم المزادات المُدرَجة سيكون هناك حدّ أقصى لعدد العناصر التي يتم عرضها استنادًا إلى حقل pageSize في الطلب.
|
nextPageToken |
string
رمز مميز لاسترداد الصفحة التالية من النتائج، أو فارغ إذا لم تتوفّر نتائج أخرى في القائمة
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/doubleclickbidmanager
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],["This document details how to list auction packages using a `GET` request to the specified URL. The `parent` path parameter is required, and `pageSize`, `pageToken`, and `filter` are optional query parameters. The request body must be empty. The response includes a list of `auctionPackage` objects and a `nextPageToken` for pagination. Authorization requires the `https://www.googleapis.com/auth/doubleclickbidmanager` OAuth scope. The filter parameter allows using `externalDealId` to find specific packages.\n"]]