این سند نمای کلی سطح بالایی از API فراداده Google Analytics را ارائه می دهد. برای مرجع دقیق API، مرجع API را بخوانید.
معرفی
Metadata API فهرست و ویژگیهای ستونها (یعنی ابعاد و معیارها) را که در APIهای گزارشدهی Google Analytics نشان داده شده است، برمیگرداند. ویژگیهای بازگشتی شامل نام رابط کاربری، توضیحات، پشتیبانی از بخشها و موارد دیگر است.
می توانید از API فراداده برای موارد زیر استفاده کنید:
- کشف خودکار ستون های جدید
- دسترسی به تمام ابعاد و ویژگیهای معیارهای APIهای گزارش Google Analytics
پاسخ زنده متادیتای API را بررسی کنید و با مطالعه راهنمای برنامهنویس بیاموزید که چگونه میتوانید از آن استفاده کنید.
بررسی اجمالی مفهومی
مفاهیم اساسی زیربنای API فراداده عبارتند از:
ستون ها
یک منبع ستون در API فراداده یک بعد یا متریک را نشان میدهد و حاوی اطلاعاتی مانند Id
و سایر ویژگیهای آن ستون است. مجموعه ای از منابع Column
همه ابعاد و معیارهای یک API گزارش را نشان می دهد.
کار با API
هنگام پرس و جو از API، نوع گزارشی را که علاقه مند به بازیابی متادیتا هستید، مشخص می کنید. پاسخ API شامل مجموعهای از تمام ستونها (یعنی ابعاد و معیارهای) موجود برای آن نوع گزارش خواهد بود. برای اطلاعات بیشتر در مورد پاسخ API و نمونه کد ، راهنمای مرجع API فراداده و برای جزئیات کار با API ، راهنمای برنامه نویس API فراداده را بخوانید.
دسترسی به API
API فراداده به احراز هویت و مجوز نیاز ندارد. در عوض، تنها شرط این است که برنامه شما هر بار که درخواستی به API آنالیتیکس ارسال می کند، خود را شناسایی کند. برای جزئیات در مورد نحوه انجام این کار به بخش دسترسی API در راهنمای برنامه نویس مراجعه کنید.
سهمیه بندی و سیاست های کاهش ارزش
Metadata API میلیون ها عملیات را انجام می دهد. برای محافظت از سیستم در برابر دریافت عملیات بیشتر از توان آن، و برای اطمینان از توزیع عادلانه منابع سیستم، لازم است از یک سیستم سهمیه استفاده شود. برای جزئیات بیشتر، راهنمای محدودیت ها و سهمیه ها را بخوانید.
برای جزئیات در مورد نحوه مدیریت تغییرات در ستونهای API گزارش (یعنی ابعاد و معیارها)، خطمشی منسوخ شدن دادهها را بخوانید. برای آشنایی با نحوه استفاده از API فراداده برای بررسی ستونهای منسوخ شده، به راهنمای برنامهنویس Metadata API مراجعه کنید.