Groups: update

שינוי המטא-נתונים של קבוצה. נכון לעכשיו, הנכס היחיד שאפשר לעדכן הוא שם הקבוצה. (משתמשים בסמלים groupItems.insert ו-groupItems.delete כדי להוסיף ולהסיר פריטים לקבוצה).

בקשה

בקשת HTTP

PUT https://youtubeanalytics.googleapis.com/v2/groups

אישור

הבקשה הזו דורשת הרשאה עם לפחות אחד מההיקפים הבאים (מידע נוסף על אימות והרשאה).

טווחים
https://www.googleapis.com/auth/yt-analytics.readonly עיון בדוחות YouTube Analytics עבור התוכן שלכם ב-YouTube. ההיקף הזה מספק גישה למדדים של פעילות המשתמשים, כמו מספר הצפיות ומספר הדירוגים.
https://www.googleapis.com/auth/yt-analytics-monetary.readonly תוכלו לצפות בדוחות כספיים של YouTube Analytics לגבי התוכן שלכם ב-YouTube. ההיקף הזה מספק גישה למדדי פעילות המשתמשים ולמדדים של ההכנסות המשוערות וביצועי המודעות.
https://www.googleapis.com/auth/youtube ניהול חשבון YouTube. ב-YouTube Analytics API, בעלי ערוצים משתמשים בהיקף הזה כדי לנהל קבוצות ופריטים מקובצים ב-YouTube Analytics.
https://www.googleapis.com/auth/youtubepartner הצגה וניהול של נכסי YouTube והתכנים המשויכים ב-YouTube. ב-YouTube Analytics API, בעלי תוכן משתמשים בהיקף הזה כדי לנהל קבוצות ופריטי קבוצות ב-YouTube Analytics.

פרמטרים

בטבלה הבאה מפורטים הפרמטרים שהשאילתה הזו תומכת בהם. כל הפרמטרים שמפורטים הם פרמטרים של שאילתות.

פרמטרים
פרמטרים אופציונליים
onBehalfOfContentOwner string
אפשר להשתמש בפרמטר הזה רק בבקשה מורשית. הערה: הפרמטר הזה מיועד אך ורק לשותפי תוכן ב-YouTube שבבעלותם מנוהלים הרבה ערוצים שונים ב-YouTube.

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

גוף הבקשה

מספקים משאב קבוצתי בגוף הבקשה. צריך לציין ערך למאפיינים הבאים של המשאב הזה. שימו לב שהבקשה מעדכנת את הערך של השדה snippet.title.

  • id
  • snippet.title

תשובה

אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר משאב קבוצה בגוף התגובה.

שגיאות

ה-API לא מגדיר הודעות שגיאה ייחודיות למתודת ה-API הזו. עם זאת, השיטה הזו עדיין תוכל להחזיר שגיאות API כלליות שמפורטות בתיעוד של הודעת השגיאה.

נסה בעצמך!

אפשר להשתמש ב-APIs Explorer כדי לשלוח קריאה ל-API הזה ולראות את בקשת ה-API והתגובה.