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

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

  https://developers.google.com/apis-explorer/#p/youtube/v3/youtube.channels.list?
          part=snippet,contentDetails
          &forUsername=Google

• מגדירים את הפרמטר id למזהה ערוץ YouTube שמזהה באופן ייחודי את הערוץ שעבורו אתם מאחזרים מידע. בדוגמה הזו, הפרמטר id מוגדר לערך UCK8sQmJBp8GCxrOtXWBpyEA, שמזהה גם את הערוץ הרשמי של Google ב-YouTube.

  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.

  הקישור ל-APIs 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. הבקשה קוראת ל-method ‏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 כי הוא לא תומך באפשרות להעלות קובצי מדיה, וזו דרישה של השיטה הזו.