YouTube Content ID API

ממשק ה-API של Content ID ב-YouTube מאפשר לנהל נכסים ב-YouTube יחד עם התוכן, ההפניות, הבעלות, הזכויות והמדיניות המשויכים אליהם.

שירות: youtubepartner.googleapis.com

כדי לקרוא לשירות הזה, מומלץ להשתמש בספריות הלקוח ש-Google מספקת. אם האפליקציה שלכם צריכה להשתמש בספריות משלכם כדי לקרוא לשירות הזה, עליכם להשתמש במידע הבא בזמן שליחת בקשות ה-API.

מסמך Discovery

מסמך Discovery הוא מפרט קריא למחשבים לתיאור ולצריכה של ממשקי API ל-REST. אפשר להשתמש בו כדי ליצור ספריות לקוח, יישומי פלאגין של סביבת פיתוח משולבת (IDE) וכלים אחרים שיוצרים אינטראקציה עם Google APIs. שירות אחד יכול לספק כמה מסמכי גילוי. השירות הזה מספק את מסמך הגילוי הבא:

נקודת קצה (endpoint) של שירות

נקודת קצה של שירות היא כתובת URL בסיסית שצוינה בה כתובת הרשת של שירות API. לשירות אחד יכולות להיות כמה נקודות קצה (endpoint) של שירות. השירות הזה כולל את נקודת הקצה הבאה של השירות, וכל מזהי ה-URI שבהמשך הם יחסיים לנקודת הקצה הזו של השירות:

  • https://youtubepartner.googleapis.com

משאב REST: assetLabels

שיטות
insert POST /youtube/partner/v1/assetLabels
להוסיף תווית של נכס לבעלים.
list GET /youtube/partner/v1/assetLabels
אחזור רשימה של כל תוויות הנכסים עבור בעלים.

משאב REST: assetMatchPolicy

שיטות
get GET /youtube/partner/v1/assets/{assetId}/matchPolicy
אחזור מדיניות ההתאמה שהוקצה לנכס שצוין על ידי בעלי התוכן שמשויך למשתמש המאומת.
patch PATCH /youtube/partner/v1/assets/{assetId}/matchPolicy
תיקון של מדיניות ההתאמה של הנכס.
update PUT /youtube/partner/v1/assets/{assetId}/matchPolicy
מעדכן את מדיניות ההתאמה של הנכס.

משאב REST: assetRelationships

שיטות
delete DELETE /youtube/partner/v1/assetRelationships/{assetRelationshipId}
מחיקה של קשר בין שני נכסים.
insert POST /youtube/partner/v1/assetRelationships
יוצר קשר שמקשר בין שני נכסים.
list GET /youtube/partner/v1/assetRelationships
אחזור רשימה של קשרים לנכס נתון.

משאב REST: assetSearch

שיטות
list GET /youtube/partner/v1/assetSearch
חיפוש נכסים על סמך המטא-נתונים שלהם.

משאב REST: assetShares

שיטות
list GET /youtube/partner/v1/assetShares
השיטה הזו מאחזרת רשימה של אחוזי בעלות בנכסים שבבעלות השותף, וממופים למזהה תצוגה מפורטת של נכס או מאחזרת רשימה של תצוגות נכסים שמשויכות למזהה שיתוף נכס שצוין בבעלות השותף.

משאב REST: assets

שיטות
get GET /youtube/partner/v1/assets/{assetId}
אחזור המטא-נתונים של הנכס שצוין.
insert POST /youtube/partner/v1/assets
הוספת נכס עם המטא-נתונים שצוינו.
list GET /youtube/partner/v1/assets
אחזור רשימת נכסים על סמך המטא-נתונים של הנכסים.
patch PATCH /youtube/partner/v1/assets/{assetId}
תיקונים של המטא-נתונים של הנכס שצוין.
update PUT /youtube/partner/v1/assets/{assetId}
עדכון המטא-נתונים של הנכס שצוין.

משאב REST: campaigns

שיטות
delete DELETE /youtube/partner/v1/campaigns/{campaignId}
מחיקת קמפיין ספציפי של בעלים.
get GET /youtube/partner/v1/campaigns/{campaignId}
אחזור של קמפיין מסוים בשביל בעלים.
insert POST /youtube/partner/v1/campaigns
הוספת קמפיין חדש לבעלים באמצעות נתוני הקמפיין שצוינו.
list GET /youtube/partner/v1/campaigns
אחזור רשימה של קמפיינים עבור בעלים.
patch PATCH /youtube/partner/v1/campaigns/{campaignId}
תיקון הנתונים בקמפיין ספציפי.
update PUT /youtube/partner/v1/campaigns/{campaignId}
מעדכנים את הנתונים של קמפיין ספציפי.

משאב REST: claimHistory

שיטות
get GET /youtube/partner/v1/claimHistory/{claimId}
אחזור היסטוריית התלונות לגבי תלונה ספציפית.

משאב REST: claimSearch

שיטות
list GET /youtube/partner/v1/claimSearch
אחזור רשימה של הצהרות שתואמות לקריטריוני החיפוש.

משאב REST: claims

שיטות
get GET /youtube/partner/v1/claims/{claimId}
אחזור של הצהרה ספציפית לפי מזהה.
insert POST /youtube/partner/v1/claims
יצירת תלונה
list GET /youtube/partner/v1/claims
אחזור רשימה של הצהרות על זכויות יוצרים שניהלו בעלי התוכן המשויכים למשתמש המאומת הנוכחי.
patch PATCH /youtube/partner/v1/claims/{claimId}
מתקן תלונה קיימת על ידי שינוי המדיניות או הסטטוס שלה.
update PUT /youtube/partner/v1/claims/{claimId}
מעדכנים תלונה קיימת על ידי שינוי המדיניות או הסטטוס שלה.

משאב REST: contentOwners

שיטות
get GET /youtube/partner/v1/contentOwners/{contentOwnerId}
אחזור מידע על בעלי התוכן שצוין.
list GET /youtube/partner/v1/contentOwners

אחזור רשימה של בעלי תוכן שתואמים לקריטריונים של הבקשה.

משאב REST: liveCuepoints

שיטות
insert POST /youtube/partner/v1/liveCuepoints
הוספת נקודת סימון לשידור חי.

משאב REST: metadataHistory

שיטות
list GET /youtube/partner/v1/metadataHistory
אחזור רשימה של כל המטא-נתונים שסופקו לנכס, ללא קשר לבעלי התוכן שסיפקו את הנתונים.

משאב REST: musicChangeRequests

שיטות
create POST /youtube/partner/v1/music/changeRequests
יוצרת בקשה לשינוי מוזיקה שדווחה לגבי גרסה או טראק.
list GET /youtube/partner/v1/music/changeRequests
אחזור רשימה של בקשות לשינויי מוזיקה שדווחו לפריט תוכן או לטראק.

משאב REST: musicReleases

שיטות
list GET /youtube/partner/v1/music/releases
אחזור רשימה של פרטי תוכן מוזיקליים.

משאב REST: musicTracks

שיטות
list GET /youtube/partner/v1/music/{parent=releases/*}/tracks
אחזור רשימה של טראקים של מוזיקה.

משאב REST: ownership

שיטות
get GET /youtube/partner/v1/assets/{assetId}/ownership
אחזור נתוני הבעלות שסופקו לנכס שצוין על ידי בעלי התוכן שמשויכים למשתמש המאומת.
patch PATCH /youtube/partner/v1/assets/{assetId}/ownership
מספקת פרטי בעלות חדשים על הנכס שצוין.
update PUT /youtube/partner/v1/assets/{assetId}/ownership
מספק פרטי בעלות חדשים לנכס שצוין.

משאב REST: ownershipHistory

שיטות
list GET /youtube/partner/v1/ownershipHistory
אחזור רשימה של נתוני הבעלות על נכס, בלי קשר לבעלי התוכן שסיפקו את הנתונים.

משאב REST: package

שיטות
get GET /youtube/partner/v1/package/{packageId}
אחזור מידע על החבילה שצוינה.
insert POST /youtube/partner/v1/package
הוספת חבילת מטא-נתונים בלבד.

משאב REST: מדיניות

שיטות
get GET /youtube/partner/v1/policies/{policyId}
אחזור של המדיניות השמורה שצוינה.
insert POST /youtube/partner/v1/policies
יצירת מדיניות שמורה.
list GET /youtube/partner/v1/policies
אחזור רשימה של כללי המדיניות השמורים של בעלי התוכן.
patch PATCH /youtube/partner/v1/policies/{policyId}
תיקונים של המדיניות השמורה שצוינה.
update PUT /youtube/partner/v1/policies/{policyId}
מעדכנת את המדיניות השמורה שצוינה.

משאב REST: referenceConflicts

שיטות
get GET /youtube/partner/v1/referenceConflicts/{referenceConflictId}
אחזור מידע על התנגשויות העזרה שצוינו.
list GET /youtube/partner/v1/referenceConflicts
אחזור רשימה של התנגשויות לא פתורות של הפניות.

משאב REST: הפניות

שיטות
get GET /youtube/partner/v1/references/{referenceId}
אחזור מידע על ההפניה שצוינה.
insert POST /youtube/partner/v1/references
POST /upload/youtube/partner/v1/references
יוצרת קובץ עזר באחת מהדרכים הבאות:
  • אם בבקשה שלכם מופיע קובץ עזר, מערכת YouTube יוצרת את קובץ העזר מהתוכן שסיפקתם.
list GET /youtube/partner/v1/references
מאחזר רשימה של הפניות לפי מזהה או את רשימת ההפניות לנכס שצוין.
patch PATCH /youtube/partner/v1/references/{referenceId}
תיקון קובץ עזר.
update PUT /youtube/partner/v1/references/{referenceId}
מעדכן קובץ עזר.

משאב REST: spreadsheetTemplate

שיטות
list GET /youtube/partner/v1/spreadsheetTemplate
אחזור רשימה של תבניות של גיליונות אלקטרוניים לבעלי תוכן.

משאב REST: uploader

שיטות
list GET /youtube/partner/v1/uploader
אחזור רשימה של מעלי תוכן של בעלי תוכן.

משאב REST: validator

שיטות
validate POST /youtube/partner/v1/validator
אימות קובץ מטא-נתונים.
validateAsync POST /youtube/partner/v1/validatorAsync
אימות קובץ מטא-נתונים באופן אסינכרוני.
validateAsyncStatus POST /youtube/partner/v1/validatorAsyncStatus
מקבלים את סטטוס האימות האסינכרוני.

משאב REST: videoAdvertisingOptions

שיטות
get GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}
אחזור הגדרות פרסום עבור הסרטון שצוין.
getEnabledAds GET /youtube/partner/v1/videoAdvertisingOptions/{videoId}/getEnabledAds
אחזור פרטים לגבי סוגי המודעות המותרות לסרטון מסוים שהועלה על ידי שותף או משתמש.
patch PATCH /youtube/partner/v1/videoAdvertisingOptions/{videoId}
תיקון של הגדרות הפרסום בסרטון שצוין.
update PUT /youtube/partner/v1/videoAdvertisingOptions/{videoId}
מעדכן את הגדרות הפרסום עבור הסרטון שצוין.

משאב REST: whitelists

שיטות
delete DELETE /youtube/partner/v1/whitelists/{id}
הסרת ערוץ מרשימת ההיתרים של בעלי התוכן.
get GET /youtube/partner/v1/whitelists/{id}
אחזור של ערוץ ספציפי ברשימת ההיתרים לפי מזהה.
insert POST /youtube/partner/v1/whitelists
הוספת ערוץ YouTube לרשימת ההיתרים של בעלי התוכן.
list GET /youtube/partner/v1/whitelists
אחזור רשימה של ערוצים ברשימת ההיתרים של בעלי תוכן.