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 إلى أنّ القناة لديها بث مباشر نشط.