Method: properties.googleAdsLinks.list

تعرض هذه الطريقة قائمة بروابط Google Ads على موقع.

طلب HTTP

GET https://analyticsadmin.googleapis.com/v1alpha/{parent=properties/*}/googleAdsLinks

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

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

المَعلمات
parent

string

الحقل مطلوب. مثال على التنسيق: properties/1234

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

المَعلمات
pageSize

integer

اختياريّ. الحد الأقصى لعدد الموارد المطلوب عرضها. إذا لم يتم تحديدها، سيتم عرض 50 موردًا على الأكثر. الحدّ الأقصى للقيمة هو 200 (سيتم فرض الحدّ الأقصى على القيم الأعلى).
pageToken

string

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

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

نص الطلب

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

نص الاستجابة

رسالة الردّ على استدعاء إجراء عن بُعد (RPC) googleAdsLinks.list.

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

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

string

رمز مميز يمكن إرساله كـ pageToken لاسترداد الصفحة التالية. في حال حذف هذا الحقل، لن تكون هناك صفحات لاحقة.

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

يجب توفير أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/analytics.readonly
  • https://www.googleapis.com/auth/analytics.edit