یک منبع report
نمونه خاصی از یک گزارش را مشخص می کند. این منبع مدت زمانی را که گزارش حاوی داده است و همچنین نشانی اینترنتی را که می توان گزارش از آن دانلود کرد، مشخص می کند.
روش ها
جدول زیر روش هایی را نشان می دهد که API برای منابع report
پشتیبانی می کند.
روش ها | |
---|---|
get | فراداده را برای یک گزارش خاص بازیابی می کند. |
list | گزارش هایی را که برای کار گزارش دهی مشخص شده ایجاد شده اند فهرست می کند. |
نمایندگی منابع JSON
ساختار JSON زیر فرمت یک منبع report
را نشان می دهد:
{ "id": string, "jobId": string, "startTime": timestamp, "endTime": timestamp, "createTime": timestamp, "jobExpireTime": timestamp, "downloadUrl": string }
خواص
جدول زیر ویژگی های ظاهر شده در این منبع را تعریف می کند:
خواص | |
---|---|
id | string شناسه ای که YouTube برای شناسایی منحصر به فرد گزارش اختصاص می دهد. هر گزارش با یک شغل مرتبط است، اگرچه یک شغل ممکن است با بسیاری از شناسه های گزارش مرتبط باشد. |
jobId | string شناسه شغلی که این گزارش را ایجاد کرده است. |
startTime | timestamp شروع دوره زمانی که نمونه گزارش پوشش می دهد. مقدار شامل یک مهر زمانی در قالب RFC3339 UTC "Zulu" است که دقت میکروثانیه دارد. مثال: "2015-10-02T15:01:23.045678Z" . |
endTime | timestamp پایان دوره زمانی که نمونه گزارش پوشش می دهد. مقدار انحصاری یک مهر زمانی در قالب RFC3339 UTC "Zulu" است که با دقت میکروثانیه است. مثال: "2015-10-02T15:01:23.045678Z" . |
createTime | timestamp تاریخ و ساعت ایجاد شغل. مقدار ویژگی یک مهر زمانی در قالب RFC3339 UTC "Zulu" است که دقت آن میکروثانیه است. مثال: "2015-10-02T15:01:23.045678Z" . |
jobExpireTime | timestamp تاریخ و زمانی که شغل مرتبط با گزارش منقضی شده یا منقضی می شود. مقدار ویژگی یک مهر زمانی در قالب RFC3339 UTC "Zulu" است که دقت آن میکروثانیه است. مثال: "2015-10-02T15:01:23.045678Z" .اگر نوع گزارش مرتبط با کار گزارش منسوخ شده باشد یا گزارشهای تولید شده برای آن کار برای مدت طولانی دانلود نشده باشد، این ویژگی دارای مقدار است. این مقدار تاریخی را نشان میدهد که پس از آن YouTube دیگر گزارشهای جدیدی برای این کار ایجاد نمیکند. اگر شغلی دارید که تاریخ انقضا را مشخص می کند، باید سیستم خود را به روز کنید تا درخواست گزارش تا آن تاریخ متوقف شود. در برخی موارد، یک گزارش جایگزین ممکن است در دسترس باشد. |
downloadUrl | string آدرس اینترنتی که می توان گزارش را از آن دانلود کرد. مقدار ویژگی حداکثر 1000 کاراکتر طول دارد. برای بازیابی گزارش، یک درخواست HTTP GET به این URL ارسال کنید. در درخواست، هدر درخواست Authorization HTTP را با استفاده از نشانه مجوز خود به عنوان مقدار سرصفحه تنظیم کنید.با استفاده از gzip با فعال کردن فشردهسازی gzip در درخواستهای دانلود، میتوانید پهنای باند مورد نیاز برای دانلود گزارشها را کاهش دهید. در حالی که برنامه شما برای فشرده سازی پاسخ های API به زمان CPU اضافی نیاز دارد، مزایای مصرف کمتر منابع شبکه معمولاً بیشتر از این هزینه است. برای دریافت پاسخ کدگذاری شده با gzip، هدر درخواست HTTP Accept-Encoding: gzip |