تعرض القائمة أدناه حالات الاستخدام الشائعة لهذه الطريقة. مرِّر مؤشر الماوس فوق إحدى حالات الاستخدام للاطّلاع على وصفها، أو انقر على إحدى حالات الاستخدام لتحميل نموذج لقيم مَعلمات في "مستكشف واجهات برمجة التطبيقات". يمكنك فتح مستكشف واجهات برمجة التطبيقات بملء الشاشة للاطّلاع على عيّنات التعليمات البرمجية التي يتم تعديلها ديناميكيًا لتعكس قيم المَعلمات التي تم إدخالها في المستكشف.
يعرض الجدول أدناه حالات الاستخدام الشائعة لهذه الطريقة. يمكنك النقر على اسم حالة استخدام لتحميل نماذج قيم مَعلمات في "مستكشف واجهات برمجة التطبيقات". أو يمكنك الاطّلاع على نماذج التعليمات البرمجية لإحدى حالات الاستخدام في مستكشف واجهات برمجة التطبيقات بملء الشاشة، وذلك بالنقر على رمز الرمز أسفل اسم حالة الاستخدام. في واجهة المستخدم بملء الشاشة، يمكنك تعديل قيم المَعلمات والخصائص وسيتم تعديل عيّنات الرموز ديناميكيًا لتعرض القيم التي تُدخلها.
لهذه الطريقة حالة استخدام واحدة شائعة، وهي موضّحة أدناه. تعمل الأزرار الموجودة أسفل الوصف على تعبئة مستكشف واجهات برمجة التطبيقات بقيم نموذجية أو فتح مستكشف واجهات برمجة التطبيقات بملء الشاشة لعرض نماذج التعليمات البرمجية التي تستخدم هذه القيم. يتم أيضًا تعديل عيّنات التعليمات البرمجية ديناميكيًا في حال تغيير القيم.
Use cases | |
---|---|
list (by keyword) | This example retrieves the first 25 search results associated with the keyword surfing. By default, the type parameter does not specify a value, which means the response could include videos, playlists, and channels. |
list (by location) | This example retrieves search results associated with the keyword surfing that also specify in their metadata a geographic location within 10 miles of the point identified by the location parameter value. (The sample request specifies a point on the North Shore of Oahu, Hawaii . The request retrieves the top five results, which is the default number returned when the maxResults parameter is not specified. |
list (live events) | This example retrieves a list of active live broadcasts (see the eventType parameter value) that are associated with the keyword news. Since the eventType parameter is set, the request must also set the type parameter value to video . |
list (my videos) | This example searches within the authorized user's videos for videos that match the keyword fun. The forMine parameter indicates that the response should only search within the authorized user's videos. Also, since this request uses the forMine parameter, it must also set the type parameter value to video .If you have not uploaded any videos associated with that term, you will not see any items in the API response list. |