یک منبع group
نشان دهنده یک گروه YouTube Analytics است که مجموعه ای سفارشی از حداکثر 500 کانال، ویدیو، لیست پخش یا دارایی است.
همه موارد در یک گروه باید یک نوع منبع را نشان دهند. به عنوان مثال، نمی توانید گروهی ایجاد کنید که دارای 100 ویدیو و 100 لیست پخش باشد.
یک گروه Analytics فقط میتواند حاوی منابعی باشد که شما آپلود یا ادعا کردهاید یا به کانالی که شما مدیریت میکنید پیوند داده شدهاند. در نتیجه، صاحبان کانال می توانند گروه هایی از ویدیوها و لیست های پخش ایجاد کنند. صاحبان محتوا میتوانند گروههایی از ویدیوها، فهرستهای پخش، کانالها یا داراییها ایجاد کنند.
مواد و روش ها
API از روش های زیر برای منابع groups
پشتیبانی می کند:
- list
- فهرستی از گروههایی را برمیگرداند که با پارامترهای درخواست API مطابقت دارند. برای مثال، میتوانید همه گروههایی را که کاربر احراز هویت شده متعلق به آنهاست بازیابی کنید، یا میتوانید یک یا چند گروه را با شناسههای منحصربهفردشان بازیابی کنید. اکنون آن را امتحان کنید .
- insert
- یک گروه YouTube Analytics ایجاد می کند. پس از ایجاد گروه، از روش
groupItems.insert
برای افزودن موارد به گروه استفاده کنید. اکنون آن را امتحان کنید . - update
- ابرداده یک گروه را اصلاح می کند. در حال حاضر تنها ویژگی قابل به روز رسانی عنوان گروه است. (از
groupItems.insert
وgroupItems.delete
برای افزودن و حذف موارد گروه استفاده کنید.) اکنون آن را امتحان کنید . - delete
- یک گروه را حذف می کند. اکنون آن را امتحان کنید .
نمایندگی منابع
ساختار JSON زیر فرمت یک منبع groups
را نشان می دهد:
{ "kind": "youtube#group", "etag": etag, "id": string, "snippet": { "publishedAt": datetime, "title": string }, "contentDetails": { "itemCount": unsigned long, "itemType": string } }
خواص
جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:
خواص | |
---|---|
kind | string نوع منبع API را مشخص می کند. مقدار youtube#group خواهد بود. |
etag | etag Etag این منبع |
id | string شناسه ای که YouTube برای شناسایی منحصر به فرد گروه استفاده می کند. |
snippet | object شی snippet حاوی اطلاعات اولیه درباره گروه، از جمله تاریخ ایجاد و نام آن است. |
snippet. publishedAt | datetime تاریخ و ساعت ایجاد گروه مقدار در قالب ISO 8601 ( YYYY-MM-DDThh:mm:ss.sZ ) مشخص شده است. |
snippet. title | string نام گروه مقدار باید یک رشته غیر خالی باشد. |
contentDetails | object شی contentDetails حاوی اطلاعات اضافی درباره گروه است، مانند تعداد و نوع مواردی که در آن وجود دارد. |
contentDetails. itemCount | unsigned long تعداد آیتم های گروه |
contentDetails. itemType | string نوع منابعی که گروه شامل می شود. مقادیر معتبر برای این ویژگی عبارتند از:
|