Groups: update
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בקשה
בקשת 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.
תשובה
אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר משאב קבוצה בגוף התגובה.
שגיאות
ה-API לא מגדיר הודעות שגיאה ייחודיות למתודת ה-API הזו. עם זאת, השיטה הזו עדיין תוכל להחזיר שגיאות API כלליות שמפורטות בתיעוד של הודעת השגיאה.
נסה בעצמך!
אפשר להשתמש ב-APIs Explorer כדי לשלוח קריאה ל-API הזה ולראות את בקשת ה-API והתגובה.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2025-08-21 (שעון UTC).
[[["התוכן קל להבנה","easyToUnderstand","thumb-up"],["התוכן עזר לי לפתור בעיה","solvedMyProblem","thumb-up"],["סיבה אחרת","otherUp","thumb-up"]],[["חסרים לי מידע או פרטים","missingTheInformationINeed","thumb-down"],["התוכן מורכב מדי או עם יותר מדי שלבים","tooComplicatedTooManySteps","thumb-down"],["התוכן לא עדכני","outOfDate","thumb-down"],["בעיה בתרגום","translationIssue","thumb-down"],["בעיה בדוגמאות/בקוד","samplesCodeIssue","thumb-down"],["סיבה אחרת","otherDown","thumb-down"]],["עדכון אחרון: 2025-08-21 (שעון UTC)."],[[["\u003cp\u003eThis API method updates the metadata of a YouTube Analytics group, specifically allowing modification of the group's title.\u003c/p\u003e\n"],["\u003cp\u003eTo use this API, you need to authorize with one of several scopes, including \u003ccode\u003eyt-analytics.readonly\u003c/code\u003e, \u003ccode\u003eyt-analytics-monetary.readonly\u003c/code\u003e, \u003ccode\u003eyoutube\u003c/code\u003e, or \u003ccode\u003eyoutubepartner\u003c/code\u003e, each providing different levels of access.\u003c/p\u003e\n"],["\u003cp\u003eThe API endpoint for updating a group's metadata is \u003ccode\u003ePUT https://youtubeanalytics.googleapis.com/v2/groups\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain a group resource with values specified for the \u003ccode\u003eid\u003c/code\u003e and \u003ccode\u003esnippet.title\u003c/code\u003e properties.\u003c/p\u003e\n"],["\u003cp\u003eContent owners managing multiple channels can use the \u003ccode\u003eonBehalfOfContentOwner\u003c/code\u003e parameter to authenticate once and access data across all their channels.\u003c/p\u003e\n"]]],["This API method updates a YouTube Analytics group's metadata, specifically the group's title. A PUT request is sent to `https://youtubeanalytics.googleapis.com/v2/groups`, requiring authorization via specific scopes for managing YouTube content and analytics. The request body must include a group resource with the `id` and the updated `snippet.title`. Content owners can use the `onBehalfOfContentOwner` parameter for channel management. Upon success, a group resource is returned.\n"],null,[]]
