דף זה תורגם על ידי Cloud Translation API.

הטמעה: ערוצים

בדף הזה נסביר איך להשתמש ב-YouTube Data API (v3) כדי לבצע פעולות שקשורות לאחזור ולעדכון של נתוני הערוץ. משאב channel כולל מזהי פלייליסטים שמזהים את הסרטונים שהועלו על ידי הערוץ ומסומנים בלייק. כדי לאחזר את המידע הזה כשמבצעים קריאה לשיטה channels.list, צריך לוודא שהערך של הפרמטר part כולל את החלק של המשאב contentDetails.

אחזור מידע על ערוץ

צריך להפעיל את השיטה channels.list כדי לאחזר מידע על ערוץ מסוים. יש כמה דרכים לזהות את הערוץ:

יש להגדיר את ערך הפרמטר mine ל-true כדי לאחזר מידע על ערוץ YouTube של המשתמש המאומת. יש לאשר את הבקשה שלך באמצעות OAuth 2.0.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=snippet,contentDetails,brandingSettings
        &mine=true
```
צריך להגדיר את הפרמטר forUsername לשם משתמש ב-YouTube כדי לאחזר מידע על הערוץ המשויך לשם המשתמש הזה. בדוגמה הזו הערך של הפרמטר forUsername מוגדר ל-Google כדי לאחזר מידע על ערוץ YouTube הרשמי של Google.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=snippet,contentDetails
        &forUsername=Google
```
מגדירים את הפרמטר id למזהה הערוץ ב-YouTube שמזהה באופן ייחודי את הערוץ שעבורו אתם מאחזרים מידע. בדוגמה הזו הפרמטר id מוגדר כ-UCK8sQmJBp8GCxrOtXWBpyEA, שמזהה גם את ערוץ YouTube הרשמי של Google.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=snippet,contentDetails
        &id=UCK8sQmJBp8GCxrOtXWBpyEA
```

הגדרת פרטי מיתוג של ערוץ

הדוגמה הזו מעדכנת את אפשרויות המיתוג של הערוץ. בדוגמה יש שני שלבים:

שלב 1: אחזור של אפשרויות המיתוג של הערוץ

צריך לקרוא לשיטה channels.list ולהגדיר את ערך הפרמטר part לערך brandingSettings, ואת ערך הפרמטר mine לערך true.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
        part=brandingSettings
        &mine=true
```
האפליקציה יכולה להציג את ההגדרות שאוחזרו, ולאפשר למשתמש לשנות את ההגדרות לעדכון.
שלב 2: מעדכנים את אפשרויות המיתוג של הערוץ

צריך לקרוא לשיטה channels.list ולהגדיר את הערכים הבאים:
- מגדירים את המאפיין id כמזהה הערוץ הייחודי של הערוץ ב-YouTube. ניתן לחלץ את המזהה מתגובת ה-API בשלב 1.
- מגדירים את ערך הפרמטר part לערך brandingSettings.
הקישור הבא ל-API Explorer יוצר משאב channel עם הגדרות המיתוג הבאות:
```
{
  "id": "CHANNEL_ID",
  "brandingSettings": {
    "channel": {
      "description": "A great channel to be enjoyed by all.",
      "moderateComments": true,
      "showRelatedChannels": true,
      "showBrowseView": true,
      "featuredChannelsTitle": "Featured Channel Stuff",
      "featuredChannelsUrls": [
        "UC_x5XG1OV2P6uZZ5FSM9Ttw",
        "UCBR8-60-B28hp2BmDPdntcQ",
        "UCK8sQmJBp8GCxrOtXWBpyEA"
      ],
      "profileColor": "#006600"
    }
  }
}
```
כדי להשלים את הבקשה ב-APIs Explorer, עליך להגדיר את הערך של המאפיין id למזהה הערוץ של הערוץ של המשתמש המאומת. צריך גם להגדיר את מאפייני התמונה כך שיתאימו להגדרות הנוכחיות.
```
https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.videos.update?
        part=brandingSettings
```

ניהול אוספים בערוץ

ה-API תומך בשיטות channelsections.list, channelSections.insert, ב-channelsections.update וב-channelsections.delete כדי לנהל אוספים בערוץ. הקטע בערוץ הוא קבוצה של סרטונים שמוצגים בערוץ. לדוגמה, מדור יכול לכלול את ההעלאות האחרונות בערוץ, את ההעלאות הפופולריות ביותר או סרטונים מפלייליסט אחד או יותר.

הדוגמה הבאה מאחזרת את הקטעים של הערוץ הרשמי של Google ב-YouTube. הבקשה קוראת לשיטה channelSections.list ומגדירה את ערך הפרמטר channelId ל-UCK8sQmJBp8GCxrOtXWBpyEA, שהוא מזהה הערוץ של הערוץ של Google.

https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channelSections.list?
part=snippet,contentDetails
&channelId=UCK8sQmJBp8GCxrOtXWBpyEA

בקשה זו מחייבת הרשאה אם, במקום להשתמש בפרמטר channelId, תגדירו את ערך הפרמטר mine ל-true. פרמטר זה מציין שאתה מאחזר קטעי ערוצים עבור הערוץ של המשתמש המאומת הנוכחי.

העלאה והגדרה של תמונת סימן מים בערוץ

אפשר להפעיל את השיטה watermarks.set כדי להעלות תמונת סימן מים ולהגדיר אותה לערוץ. לאחר מכן, התמונה מוצגת במהלך הפעלות של הסרטונים בערוץ שצוין. אפשר גם לציין ערוץ יעד שאליו התמונה תקושר, וגם פרטי תזמון שקובעים מתי יופיע סימן המים וכמה זמן הוא יהיה גלוי.

השיטה watermarks.unset מוחקת את תמונת סימן המים של ערוץ.

לצערנו, לא ניתן לבדוק את השאילתה הזו באמצעות APIs Explorer, מכיוון ש-APIs Explorer לא תומך בהעלאת קובצי מדיה. זוהי דרישת חובה של שיטה זו.