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 )

اطلاعات اشتراک درآمد از راه N (Pangea).

تضادهای مالکیت

منبع 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 است.

تضادهای سرزمینی

روشی برای جستجوی ترورها با تضاد مالکیت.

نمایندگی JSON
{
  "territory": string,
  "conflictingOwnership": [
    {
      object (ConflictingOwnership)
    }
  ]
}
زمینه های
territory

string

مناطقی که تضاد مالکیت در آن وجود دارد. قلمرو یک کد کشور دو حرفی ISO 3166 است. .

conflictingOwnership[]

object ( ConflictingOwnership )

فهرستی از مالکیت های متضاد

مالکیت متضاد

اطلاعات مربوط به یکی از مالکیت های متضاد را نشان می دهد.

نمایندگی JSON
{
  "ratio": number,
  "owner": string
}
زمینه های
ratio

number

درصدی از دارایی که مالک آن را کنترل یا مدیریت می کند.

owner

string

شناسه مالک دارایی متضاد.

قابلیت مجوز دارایی

اطلاعات مربوط به مجوز دارایی

نمایندگی JSON
{
  "licensable": boolean,
  "licensabilityState": string,
  "unlicensableReason": [
    string
  ]
}
زمینه های
licensable

boolean

اینکه آیا دارایی تطبیق شده قابل صدور مجوز است یا خیر.

licensabilityState

string

وضعیت مجاز بودن دارایی

unlicensableReason[]

string

دلیل عدم مجوز دارایی

NWayRevenueSharing

اشتراک n-way دارایی اطلاعاتی.

نمایندگی JSON
{
  "status": string,
  "eligibleTerritories": [
    string
  ],
  "ineligibleTerritories": [
    {
      object (TerritoriesIneligibleForNWayRevenueSharing)
    }
  ]
}
زمینه های
status

string

وضعیت اشتراک درآمد از طریق n.

eligibleTerritories[]

string

هر کشور با کد کشور ISO دو حرفی خود (ISO 3166-1 alpha-2) نشان داده می شود.

ineligibleTerritories[]

object ( TerritoriesIneligibleForNWayRevenueSharing )

اطلاعات مربوط به مناطقی که دارایی در آن ها برای اشتراک درآمد از طریق n واجد شرایط نیست.

مناطق غیر واجد شرایط برای NWaySharing درآمد

اطلاعات مربوط به مناطقی که دارایی برای اشتراک‌گذاری مجدد n-way واجد شرایط نیست.

نمایندگی JSON
{
  "reason": string,
  "territories": [
    string
  ]
}
زمینه های
reason

string

دلیل عدم صلاحیت برای مناطق ذکر شده در زیر.

territories[]

string

هر کشور با کد کشور ISO دو حرفی خود (ISO 3166-1 alpha-2) نشان داده می شود.

مواد و روش ها

get

فراداده را برای دارایی مشخص شده بازیابی می کند.

insert

دارایی را با فراداده مشخص شده درج می کند.

list

فهرستی از دارایی ها را بر اساس فراداده دارایی بازیابی می کند.

patch

متادیتا را برای دارایی مشخص شده وصله می کند.

update

فراداده را برای دارایی مشخص شده به روز می کند.