Method: claims.list

لاسترداد قائمة بالمطالبات التي يديرها مالك المحتوى والمرتبطة بالمستخدم الذي تمت مصادقته حاليًا. يتم ترتيب النتائج تنازليًا حسب وقت الإنشاء.

طلب HTTP

GET https://youtubepartner.googleapis.com/youtube/partner/v1/claims

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

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

المَعلمات
assetId

string

استخدِم المَعلمة assetId لطريقة claimSearch.list للبحث عن مقتطفات المطالبة حسب رقم تعريف مادة العرض. يمكنك بعد ذلك استرداد موارد claim لهذه المطالبات باستخدام مَعلمة id الخاصة بهذه الطريقة لتحديد قائمة مفصولة بفواصل من معرّفات المطالبات.
id

string

تحدد المعلَمة id قائمة بمعرفات مطالبات YouTube مفصولة بفواصل لاستردادها.
onBehalfOfContentOwner

string

تحدِّد المَعلمة onBehalfOfContentOwner مالك المحتوى الذي يتصرف المستخدم نيابةً عنه. تدعم هذه المَعلمة المستخدمين الذين ترتبط حساباتهم بالعديد من مالكي المحتوى.
pageToken

string

تحدد المعلمة pageToken رمزًا مميزًا يحدد صفحة معينة من النتائج المراد عرضها. على سبيل المثال، يمكنك ضبط هذه المَعلمة على قيمة nextPageToken من ردّ واجهة برمجة التطبيقات السابق لاسترداد الصفحة التالية من نتائج البحث.
q

string

استخدم معلمة claimSearch.list الطريقة q للبحث عن مقتطفات المطالبة التي تتطابق مع سلسلة طلب بحث معيّنة. يمكنك بعد ذلك استرداد موارد claim لهذه المطالبات باستخدام مَعلمة id الخاصة بهذه الطريقة لتحديد قائمة مفصولة بفواصل من معرّفات المطالبات.
videoId

string

استخدِم المَعلمة videoId الخاصة بطريقة claimSearch.list للبحث عن مقتطفات المطالبة حسب معرّف الفيديو. يمكنك بعد ذلك استرداد موارد claim لهذه المطالبات باستخدام مَعلمة id الخاصة بهذه الطريقة لتحديد قائمة مفصولة بفواصل من معرّفات المطالبات.

نص الطلب

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

نص الاستجابة

قائمة مقسّمة على صفحات تضم المطالبات التي تم عرضها استجابةً لمكالمة claims.list

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

تمثيل JSON 
{
  "kind": string,
  "pageInfo": {
    object (PageInfo)
  },
  "items": [
    {
      object (Claim)
    }
  ],
  "nextPageToken": string,
  "previousPageToken": string
}
الحقول
kind

string

تمثّل هذه السمة نوع استجابة واجهة برمجة التطبيقات. بالنسبة إلى هذه العملية، تكون القيمة هي youtubePartner#claimList.
pageInfo

object (PageInfo)

يغلف الكائن pageInfo معلومات التقسيم على صفحات لمجموعة النتائج.
items[]

object (Claim)

قائمة بالمطالبات التي تطابق معايير الطلب
nextPageToken

string

الرمز المميّز الذي يمكن استخدامه كقيمة للمَعلمة pageToken لاسترداد الصفحة التالية في مجموعة النتائج
previousPageToken

string

الرمز المميّز الذي يمكن استخدامه كقيمة للمَعلمة pageToken لاسترداد الصفحة السابقة في مجموعة النتائج

نطاقات التفويض

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/youtubepartner

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.