REST Resource: assets

משאב: נכס

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

ייצוג JSON 
{
  "kind": string,
  "type": string,
  "status": string,
  "metadata": {
    object (Metadata)
  },
  "ownership": {
    object (RightsOwnership)
  },
  "matchPolicy": {
    object (AssetMatchPolicy)
  },
  "timeCreated": string,
  "metadataMine": {
    object (Metadata)
  },
  "metadataEffective": {
    object (Metadata)
  },
  "ownershipMine": {
    object (RightsOwnership)
  },
  "ownershipEffective": {
    object (RightsOwnership)
  },
  "matchPolicyMine": {
    object (AssetMatchPolicy)
  },
  "matchPolicyEffective": {
    object (AssetMatchPolicy)
  },
  "ownershipConflicts": {
    object (OwnershipConflicts)
  },
  "id": string,
  "aliasId": [
    string
  ],
  "label": [
    string
  ],
  "licensability": {
    object (AssetLicensability)
  },
  "nWayRevenueSharing": {
    object (NWayRevenueSharing)
  }
}
שדות
kind

string

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

string

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

הערכים החוקיים לנכס הזה הם:

  • art_track_video

  • composition

  • episode

  • general

  • movie

  • music_video

  • season

  • show

  • sound_recording

  • video_game

  • web
status

string

סטטוס הנכס.
metadata

object (Metadata)

האובייקט metadata מכיל מידע שמזהה ומתאר את הנכס. אפשר להשתמש במידע הזה כדי לחפש את הנכס או כדי לבטל כפילויות במסד הנתונים של YouTube.
ownership

object (RightsOwnership)

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

object (AssetMatchPolicy)

האובייקט matchPolicy מכיל מידע על מדיניות ההתאמה של הנכס, שאותה מערכת YouTube מחילה על סרטונים שהועלו על ידי משתמשים ושתואמים לנכס.
timeCreated

string

התאריך והשעה שבהם הנכס נוצר. הערך מצוין בפורמט RFC 3339 (YYYY-MM-DDThh:mm:ss.000Z).
metadataMine

object (Metadata)
metadataEffective

object (Metadata)
ownershipMine

object (RightsOwnership)
ownershipEffective

object (RightsOwnership)
matchPolicyMine

object (AssetMatchPolicy)
matchPolicyEffective

object (AssetMatchPolicy)
ownershipConflicts

object (OwnershipConflicts)

האובייקט ownershipConflicts מכיל מידע על מחלוקות לגבי הבעלות על הנכס.
id

string

מזהה ש-YouTube מקצה ומשתמשת בו כדי לזהות את הנכס באופן ייחודי.
aliasId[]

string

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

string

רשימת התוויות לסימון הנכס.
licensability

object (AssetLicensability)

מידע על ההתאמה של הנכס לרישוי.
nWayRevenueSharing

object (NWayRevenueSharing)

מידע על חלוקת הכנסות (Pangea) בדרך כלל.

OwnershipConflicts

המשאב ownershipConflicts מייצג מידע על הבעלות המתנגשת על הנכס.

ייצוג JSON 
{
  "general": [
    {
      object (TerritoryConflicts)
    }
  ],
  "performance": [
    {
      object (TerritoryConflicts)
    }
  ],
  "synchronization": [
    {
      object (TerritoryConflicts)
    }
  ],
  "mechanical": [
    {
      object (TerritoryConflicts)
    }
  ],
  "kind": string
}
שדות
general[]

object (TerritoryConflicts)

רשימה שמזהה מחלוקות בנושא בעלות על נכס והאזורים שבהם הוכנסה בעלות סותרת.
performance[]

object (TerritoryConflicts)

רשימה שמזהה מחלוקות בנושא בעלות על זכויות הביצוע בנכס יצירה מוזיקלית, והאזורים שבהם הוכנסה בעלות סותרת.
synchronization[]

object (TerritoryConflicts)

רשימה שמזהה התנגשויות בעלות על זכויות הסנכרון של נכס ביצירה, והאזורים שבהם הוכנסה בעלות סותרת.
mechanical[]

object (TerritoryConflicts)

רשימה שמזהה סכסוכים בנוגע לבעלות על הזכויות המכניות של נכס ביצירה, והאזורים שבהם הוכנסה בעלות סותרת.
kind

string

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

TerritoryConflicts

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

ייצוג JSON 
{
  "territory": string,
  "conflictingOwnership": [
    {
      object (ConflictingOwnership)
    }
  ]
}
שדות
territory

string

אזורים שבהם קיימת מחלוקת לגבי הבעלות. האזור הוא קוד מדינה בן שתי אותיות לפי תקן ISO 3166.
conflictingOwnership[]

object (ConflictingOwnership)

רשימה של בעלות סותרת

ConflictingOwnership

מייצג מידע על בעלות סותרת אחת.

ייצוג JSON 
{
  "ratio": number,
  "owner": string
}
שדות
ratio

number

אחוז הנכס שנמצא בשליטת הבעלים או בניהולו.
owner

string

המזהה של הבעלים של הנכס בעל המאפיינים הזהים לחשבון פעיל.

AssetLicensability

מידע על ההתאמה של הנכס לרישוי.

ייצוג JSON 
{
  "licensable": boolean,
  "licensabilityState": string,
  "unlicensableReason": [
    string
  ]
}
שדות
licensable

boolean

האם הנכס המותאם מתאים לרישוי.
licensabilityState

string

סטטוס ההתאמה של הנכס לרישוי.
unlicensableReason[]

string

הסיבה לכך שהנכס לא מתאים לרישוי.

NWayRevenueSharing

חלוקת הכנסות לא חד-כיוונית של נכס מידע.

ייצוג JSON 
{
  "status": string,
  "eligibleTerritories": [
    string
  ],
  "ineligibleTerritories": [
    {
      object (TerritoriesIneligibleForNWayRevenueSharing)
    }
  ]
}
שדות
status

string

הסטטוס של חלוקת הכנסות בכיוון מסוים.
eligibleTerritories[]

string

כל מדינה מיוצגת באמצעות קוד מדינה בן שתי אותיות לפי תקן ISO (ISO 3166-1 alpha-2).
ineligibleTerritories[]

object (TerritoriesIneligibleForNWayRevenueSharing)

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

TerritoriesIneligibleForNWayRevenueSharing

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

ייצוג JSON 
{
  "reason": string,
  "territories": [
    string
  ]
}
שדות
reason

string

סיבת הדחייה של האזורים המפורטים בהמשך.
territories[]

string

כל מדינה מיוצגת באמצעות קוד מדינה בן שתי אותיות לפי תקן ISO (ISO 3166-1 alpha-2).

שיטות

get

 אחזור המטא-נתונים של הנכס שצוין.

insert

 הוספת נכס עם המטא-נתונים שצוינו.

list

 אחזור רשימה של נכסים על סמך מטא-נתונים של נכס.

patch

 תיקונים המטא-נתונים של הנכס שצוין.

update

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