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

בדף הזה מוסבר איך להשתמש ב-YouTube Data API (גרסה 3) כדי לבצע פונקציות שקשורות לאחזור ולעדכון של נתוני הערוץ. משאב 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"
      }
    }
  }

  כדי להשלים את הבקשה ב-API 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 לניהול קטעי הערוץ. קטע בערוץ הוא קבוצה של סרטונים שמופיעים בערוץ. לדוגמה, קטע יכול לכלול את ההעלאות האחרונות של הערוץ, את ההעלאות הפופולריות ביותר או סרטונים מפלייליסט אחד או יותר.

בדוגמה הבאה מתבצעת אחזור של קטעי הערוץ של ערוץ YouTube הרשמי של Google. הבקשה מפעילה את השיטה 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 מוחקת את תמונת סימן המים של הערוץ.

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