تعرض هذه السمة المجموعات الإعلانية.
طلب HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/adGroups
يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.
مَعلمات المسار
المعلمات | |
---|---|
advertiserId |
الحقل مطلوب. رقم تعريف المعلِن الذي تنتمي إليه المجموعات الإعلانية. |
مَعلمات طلب البحث
المعلمات | |
---|---|
pageSize |
اختيارية: حجم الصفحة المطلوب يجب أن تتراوح القيمة بين |
pageToken |
اختيارية: رمز مميّز يحدّد صفحة من النتائج التي يجب أن يعرضها الخادم. عادةً، تكون هذه القيمة هي قيمة |
orderBy |
اختيارية: الحقل الذي سيتم ترتيب القائمة حسبه القيم المقبولة هي:
يكون ترتيب الفرز التلقائي تصاعديًا. لتحديد ترتيب تنازلي لحقل معيّن، يجب إضافة اللاحقة "desc" إلى اسم الحقل. مثال: |
filter |
اختيارية: تتيح الفلترة حسب حقول المجموعات الإعلانية المخصّصة. بنية الجملة المتوافقة:
السمات المتاحة:
أمثلة:
يجب ألا يزيد طول هذا الحقل عن 500 حرف. يُرجى الرجوع إلى دليل طلبات |
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{
"adGroups": [
{
object ( |
الحقول | |
---|---|
adGroups[] |
قائمة المجموعات الإعلانية. لن تظهر هذه القائمة إذا كانت فارغة. |
nextPageToken |
رمز مميز لاسترداد الصفحة التالية من النتائج. مرِّر هذه القيمة في الحقل |
نطاقات الأذونات
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/display-video
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.