Search

تحتوي نتيجة search على معلومات عن فيديو أو قناة أو قائمة تشغيل على YouTube تتطابق مع مَعلمات البحث المحدّدة في طلب البيانات من واجهة برمجة التطبيقات. على الرغم من أنّ نتيجة البحث تشير إلى مورد يمكن التعرّف عليه بشكل فريد، مثل فيديو، إلا أنّها لا تحتوي على بيانات دائمة خاصة بها.

الطُرق

تتيح واجهة برمجة التطبيقات الطرق التالية للبحث:

list
تعرض مجموعة من نتائج البحث التي تتطابق مع مَعلمات طلب البحث المحدّدة في طلب البيانات من واجهة برمجة التطبيقات. بشكلٍ تلقائي، تُحدِّد مجموعة نتائج البحث موارد video وchannel وplaylist المطابقة، ولكن يمكنك أيضًا ضبط طلبات البحث لاسترداد نوع معيّن من الموارد فقط. جرِّب ذلك الآن.

تمثيل الموارد

تعرض بنية JSON التالية تنسيق نتيجة البحث:

{
  "kind": "youtube#searchResult",
  "etag": etag,
  "id": {
    "kind": string,
    "videoId": string,
    "channelId": string,
    "playlistId": string
  },
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "channelTitle": string,
    "liveBroadcastContent": string
  }
}

أماكن إقامة

يحدّد الجدول التالي السمات التي تظهر في نتيجة البحث:

أماكن إقامة
kind string
لتحديد نوع مورد واجهة برمجة التطبيقات. ستكون القيمة youtube#searchResult.
etag etag
رقم تعريف Etag لهذا المورد.
id object
يحتوي عنصر id على معلومات يمكن استخدامها لتحديد المورد الذي يتطابق مع طلب البحث بشكل فريد.
id.kind string
نوع مورد واجهة برمجة التطبيقات.
id.videoId string
إذا كانت قيمة السمة id.type هي youtube#video، ستظهر هذه السمة وستحتوي قيمتها على المعرّف الذي تستخدمه YouTube لتحديد فيديو يتطابق مع طلب البحث بشكل فريد.
id.channelId string
إذا كانت قيمة السمة id.type هي youtube#channel، ستظهر هذه السمة وستحتوي قيمتها على رقم التعريف الذي تستخدمه YouTube لتحديد قناة تتطابق مع طلب البحث بشكل فريد.
id.playlistId string
إذا كانت قيمة السمة id.type هي youtube#playlist، ستظهر هذه السمة وستحتوي قيمتها على رقم التعريف الذي تستخدمه YouTube لتحديد قائمة تشغيل بشكل فريد تتطابق مع طلب البحث.
snippet object
يحتوي عنصر snippet على تفاصيل أساسية عن نتيجة بحث معيّنة، مثل عنوانها أو وصفها. على سبيل المثال، إذا كانت نتيجة البحث هي فيديو، سيكون العنوان هو عنوان الفيديو والوصف هو وصف الفيديو.
snippet.publishedAt datetime
تاريخ ووقت إنشاء المرجع الذي تحدّده نتيجة البحث يتم تحديد القيمة بتنسيق ISO 8601.
snippet.channelId string
القيمة التي تستخدمها YouTube لتحديد القناة التي نشرت المورد الذي تحدّده نتيجة البحث بشكل فريد
snippet.title string
عنوان نتيجة البحث.
snippet.description string
وصف لنتيجة البحث
snippet.thumbnails object
خريطة للصور المصغّرة المرتبطة بنتيجة البحث بالنسبة إلى كل عنصر في الخريطة، يكون المفتاح هو اسم الصورة المصغّرة، والقيمة هي عنصر يحتوي على معلومات أخرى عن الصورة المصغّرة.
snippet.thumbnails.(key) object
في ما يلي قيم المفاتيح الصالحة:
  • default: الصورة المصغّرة التلقائية يبلغ عرض الصورة المصغّرة التلقائية للفيديو أو المرجع الذي يشير إلى فيديو، مثل عنصر قائمة تشغيل أو نتيجة بحث، 120 بكسل وارتفاعها 90 بكسل. يبلغ العرض التلقائي للصورة المصغّرة للقناة 88 بكسل والارتفاع 88 بكسل.
  • ‫medium: نسخة بدرجة دقة أعلى من الصورة المصغّرة بالنسبة إلى الفيديو (أو المرجع الذي يشير إلى فيديو)، يكون عرض هذه الصورة 320 بكسل وارتفاعها 180 بكسل. بالنسبة إلى القناة، يكون عرض هذه الصورة 240 بكسل وارتفاعها 240 بكسل.
  • ‫high: نسخة عالية الدقة من الصورة المصغّرة بالنسبة إلى الفيديو (أو المرجع الذي يشير إلى فيديو)، يكون عرض هذه الصورة 480 بكسل وارتفاعها 360 بكسل. بالنسبة إلى القناة، يكون عرض هذه الصورة 800 بكسل وارتفاعها 800 بكسل.
  • ‫standard: نسخة بدرجة دقة أعلى من الصورة المصغّرة مقارنةً بالصورة التي تبلغ دقتها high. تتوفّر هذه الصورة لبعض الفيديوهات والموارد الأخرى التي تشير إلى الفيديوهات، مثل عناصر قوائم التشغيل أو نتائج البحث. يبلغ عرض هذه الصورة 640 بكسل وارتفاعها 480 بكسل.
  • ‫maxres: النسخة الأعلى دقة من الصورة المصغّرة يتوفّر حجم الصورة هذا لبعض الفيديوهات والموارد الأخرى التي تشير إلى الفيديوهات، مثل عناصر قوائم التشغيل أو نتائج البحث. هذه الصورة بعرض 1280 بكسل وارتفاع 720 بكسل.
snippet.thumbnails.(key).url string
عنوان URL للصورة.
snippet.thumbnails.(key).width unsigned integer
عرض الصورة.
snippet.thumbnails.(key).height unsigned integer
ارتفاع الصورة.
snippet.channelTitle string
عنوان القناة التي نشرت المرجع الذي تحدّده نتيجة البحث.
snippet.liveBroadcastContent string
يشير ذلك إلى ما إذا كان المورد video أو channel يتضمّن محتوى بث مباشر. القيم الصالحة للخاصية هي upcoming وlive وnone.

بالنسبة إلى مورد video، تشير القيمة upcoming إلى أنّ الفيديو هو بث مباشر لم يبدأ بعد، في حين تشير القيمة live إلى أنّ الفيديو هو بث مباشر نشط. بالنسبة إلى مورد channel، تشير القيمة upcoming إلى أنّ القناة لديها بث مُجدوَل لم يبدأ بعد، في حين تشير القيمة live إلى أنّ القناة لديها بث مباشر نشط.