Google uses AI technology to translate content into your preferred language. AI translations can contain errors.
Method: campaigns.list
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
لاسترداد قائمة الحملات الخاصة بمالك معيّن
طلب HTTP
GET https://youtubepartner.googleapis.com/youtube/partner/v1/campaigns
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات طلب البحث
| المعلمات |
onBehalfOfContentOwner |
string
تحدِّد المَعلمة onBehalfOfContentOwner مالك المحتوى الذي يتصرّف المستخدم نيابةً عنه. تتيح هذه المَعلمة للمستخدمين الذين تم ربط حساباتهم بالعديد من مالكي المحتوى.
|
pageToken |
string
تحدِّد المَعلمة pageToken رمزًا مميّزًا يحدِّد صفحة معيّنة من النتائج المراد عرضها. على سبيل المثال، اضبط هذه المَعلمة على قيمة nextPageToken من استجابة واجهة برمجة التطبيقات السابقة لاسترداد الصفحة التالية من نتائج البحث.
|
نص الطلب
يجب أن يكون نص الطلب فارغًا.
نص الاستجابة
campaigns.list: الحملات المرتبطة بمالك المحتوى
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
| تمثيل JSON |
{
"kind": string,
"items": [
{
object (Campaign)
}
]
} |
| الحقول |
kind |
string
نوع ردّ واجهة برمجة التطبيقات. بالنسبة إلى هذه العملية، تكون القيمة youtubePartner#campaignList.
|
items[] |
object (Campaign)
قائمة بالحملات
|
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/youtubepartner
لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.
جميع الحقوق محفوظة. إنّ Java علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-08-21 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","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-08-21 (حسب التوقيت العالمي المتفَّق عليه)"],[],["This document details how to retrieve a list of campaigns via a `GET` request to `https://youtubepartner.googleapis.com/youtube/partner/v1/campaigns`. The request requires an empty body but may include `onBehalfOfContentOwner` and `pageToken` query parameters. Successful responses return a JSON structure with a `kind` field and an `items` array, listing campaigns. The operation requires the `https://www.googleapis.com/auth/youtubepartner` OAuth scope for authorization.\n"]]