אנחנו מעדכנים את ממשקי ה-API של YouTube Analytics ושל Reporting API בהתאם לאופן שבו YouTube סופר צפיות ב-Shorts.
מידע נוסף
Groups: insert
קל לארגן דפים בעזרת אוספים
אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
יצירת קבוצה ב-YouTube Analytics. אחרי שיוצרים קבוצה, משתמשים בשיטה groupItems.insert
כדי להוסיף פריטים לקבוצה.
בקשה
בקשת HTTP
POST 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
contentDetails.itemType
תשובה
אם הפעולה בוצעה ללא שגיאות, ה-method מחזיר משאב קבוצה בגוף התגובה.
שגיאות
ה-API לא מגדיר הודעות שגיאה ייחודיות למתודת ה-API הזו. עם זאת, השיטה הזו עדיין תוכל להחזיר שגיאות API כלליות שמפורטות בתיעוד של הודעת השגיאה.
נסה בעצמך!
משתמשים ב-APIs Explorer כדי לקרוא ל-API הזה ולראות את הבקשה והתגובה של ה-API.
אלא אם צוין אחרת, התוכן של דף זה הוא ברישיון Creative Commons Attribution 4.0 ודוגמאות הקוד הן ברישיון Apache 2.0. לפרטים, ניתן לעיין במדיניות האתר Google Developers. Java הוא סימן מסחרי רשום של חברת Oracle ו/או של השותפים העצמאיים שלה.
עדכון אחרון: 2024-11-09 (שעון 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"]],["עדכון אחרון: 2024-11-09 (שעון UTC)."],[[["This API method creates a new YouTube Analytics group, which can be populated with items via the `groupItems.insert` method."],["Authorization for this request requires one of four possible scopes, including options for read-only access to analytics data, monetary reports, or management of YouTube accounts and assets."],["The API call uses a POST request to `https://youtubeanalytics.googleapis.com/v2/groups`."],["The request body must contain a group resource with values specified for `snippet.title` and `contentDetails.itemType`."],["The `onBehalfOfContentOwner` parameter allows content partners to authenticate once to access data for multiple channels they manage, and it is intended exclusively for that use case."]]],["This outlines how to create a YouTube Analytics group via a POST request to `https://youtubeanalytics.googleapis.com/v2/groups`. Authorization requires specific scopes, including read-only and monetary analytics, channel management, or content partner access. The request body must include a group resource with `snippet.title` and `contentDetails.itemType`. Content owners can use `onBehalfOfContentOwner` to manage multiple channels. Upon success, a group resource is returned. Items can be added to the group using the `groupItems.insert` method.\n"]]