REST Resource: claims

משאב: תלונה

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

ייצוג JSON 
{
  "kind": string,
  "policy": {
    object (Policy)
  },
  "timeCreated": string,
  "contentType": string,
  "ugcType": string,
  "isPartnerUploaded": boolean,
  "timeStatusLastModified": string,
  "blockOutsideOwnership": boolean,
  "status": string,
  "appliedPolicy": {
    object (Policy)
  },
  "id": string,
  "assetId": string,
  "videoId": string,
  "origin": {
    object (Origin)
  },
  "matchInfo": {
    object (MatchInfo)
  },
  "studioInfo": {
    object (StudioInfo)
  }
}
שדות
kind

string

הסוג של משאב ה-API. ב-claim משאבים, הערך הוא youtubePartner#claim.
policy

object (Policy)

המדיניות שסופקה על ידי הבעלים של התוכן שצפה בתלונה.
timeCreated

string

השעה שבה נוצרה התלונה על הפרת זכויות יוצרים.
contentType

string

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

string

סוג התוכן שנוצר על ידי המשתמש (רגילה, פרימיום, שיר).
isPartnerUploaded

boolean

מציין אם התלונה היא תלונה שהועלתה על ידי שותף.
timeStatusLastModified

string

המועד שבו בוצע השינוי האחרון בסטטוס התלונה ו/או בפרטי הסטטוס.
blockOutsideOwnership

boolean

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

string

סטטוס התלונה. כשמעדכנים תלונה, אפשר לעדכן את הסטטוס שלה מ-active ל-inactive כדי לבטל את התלונה ביעילות, אבל ה-API לא תומך בעדכונים אחרים בסטטוס התלונה.
appliedPolicy

object (Policy)

המדיניות שמוחלת על הבעלים של הצפייה בתלונה. המדיניות הזו עשויה להיות שונה מהמדיניות הסופית בנושא תלונות על הפרת זכויות יוצרים בסרטון, כי היא לא מביאה בחשבון שותפים אחרים המדיניות לגבי אותה הצהרה.
id

string

המזהה שמערכת YouTube מקצה ומשתמשת בו כדי לזהות את התלונה באופן ייחודי.
assetId

string

מזהה הנכס הייחודי ב-YouTube שמזהה את הנכס שמשויך לתלונה.
videoId

string

מזהה הסרטון הייחודי ב-YouTube שמזהה את הסרטון המשויך לתלונה.
origin

object (Origin)
matchInfo

object (MatchInfo)

אם התלונה הזו נוצרה באופן אוטומטי על סמך קובץ עזר שסיפקתם, הקטע הזה יספק פרטים על ההתאמה שיצרה את התלונה.
studioInfo

object (StudioInfo)

מכילה כתובות URL שמקשרות בחזרה לדפים שקשורים לתלונות ב-Studio.

מקור

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

ייצוג JSON 
{
  "source": string
}
שדות
source

string

MatchInfo

התאמת פרטים על התלונה.

ייצוג JSON 
{
  "matchSegments": [
    {
      object (MatchSegment)
    }
  ],
  "referenceId": string,
  "longestMatch": {
    object (LongestMatch)
  },
  "totalMatch": {
    object (TotalMatch)
  }
}
שדות
matchSegments[]

object (MatchSegment)

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

string

מזהה קובץ העזר שיצר את ההתאמה הזו.
longestMatch

object (LongestMatch)

פרטים על ההתאמה הארוכה ביותר בין קובץ העזר לבין סרטון המשתמש.
totalMatch

object (TotalMatch)

פרטים על הכמות הכוללת של קובצי עזר ותוכן וידאו של משתמשים שתאמו זה לזה. הערה: שני הערכים האלה עשויים להיות שונים, אם ההפניה או סרטון המשתמש מכילים לולאה.

MatchSegment

מידע על קטע התאמה יחיד בתלונה.

ייצוג JSON 
{
  "video_segment": {
    object (Segment)
  },
  "reference_segment": {
    object (Segment)
  },
  "channel": string,
  "manual_segment": {
    object (Segment2)
  }
}
שדות
video_segment

object (Segment)

האובייקט videoSegment מכיל מידע על החלק שנמצאה בו התאמה בסרטון שהוגשה לגביו תלונה על הפרת זכויות יוצרים.
reference_segment

object (Segment)

האובייקט referenceSegment מכיל מידע על החלק התואם בתוכן העזר.
channel

string

מזהה את האופן שבו הסרטון שהוגשה לגביו תלונה על הפרת זכויות יוצרים תואם לסרטון העזר.
manual_segment

object (Segment2)

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

פילוח

המשאב הזה מייצג פלח פשוט עם שעת התחלה ושעת סיום בפורמט הבא: hh:mm:ss.mmm String.

ייצוג JSON 
{
  "start": string,
  "duration": string,
  "kind": string
}
שדות
start

string

שעת ההתחלה של הקטע, שנמדדת באלפיות השנייה מתחילתו.
duration

string

משך הזמן של הקטע באלפיות השנייה.
kind

string

הסוג של משאב ה-API. בפילוח של משאבים, הערך הוא youtubePartner#segment.

Segment2

המשאב הזה מייצג קטע פשוט נוסף עם שעת התחלה ושעת סיום בפורמט הבא: hh:mm:ss.mmm String.

ייצוג JSON 
{
  "start": string,
  "kind": string,
  "finish": string
}
שדות
start

string

שעת ההתחלה של הקטע, שנמדדת באלפיות השנייה מתחילתו.
kind

string

הסוג של משאב ה-API. בפילוח של משאבים, הערך הוא youtubePartner#segment.
finish

string

זמן הסיום של הקטע, שנמדד באלפיות השנייה מתחילתו.

LongestMatch

ההתאמה הארוכה ביותר של תלונה על הפרת זכויות יוצרים.

ייצוג JSON 
{
  "durationSecs": string,
  "userVideoOffset": string,
  "referenceOffset": string
}
שדות
durationSecs

string

משך ההתאמה הארוכה ביותר בין קובץ העזר לבין סרטון המשתמש.
userVideoOffset

string

ההיסט בשניות לתוך סרטון המשתמש שבו התחילה ההתאמה הארוכה ביותר.
referenceOffset

string

ההיסט בשניות לתוך קובץ העזר שבו התחילה ההתאמה הארוכה ביותר.

TotalMatch

התאמה מלאה לתלונות.

ייצוג JSON 
{
  "userVideoDurationSecs": string,
  "referenceDurationSecs": string
}
שדות
userVideoDurationSecs

string

הכמות הכוללת של תוכן בסרטון המשתמש שתאמה לקובץ העזר בשניות.
referenceDurationSecs

string

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

שיטות

get

 אחזור של הצהרה ספציפית לפי מזהה.

insert

 יצירת תלונה

list

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

patch

 מתקן תלונה קיימת על ידי שינוי המדיניות או הסטטוס שלה.

update

 מעדכנים תלונה קיימת על ידי שינוי המדיניות או הסטטוס שלה.