نمای کلی API Admin Google Analytics

خلاصه : این سند یک مرور کلی سطح بالا از رابط برنامه‌نویسی کاربردی مدیریت گوگل آنالیتیکس نسخه ۱.۰ ارائه می‌دهد.

این API ویژگی‌هایی را در کانال‌های آلفا و بتا ارائه می‌دهد. محصولات آلفا و بتا ممکن است پشتیبانی محدودی داشته باشند و تغییرات در این محصولات ممکن است با سایر نسخه‌های آلفا و بتا سازگار نباشد.

آلفا : ویژگی‌ها در مرحله پیش‌نمایش اولیه هستند. در حالی که ما سعی می‌کنیم شما را از تغییرات آینده مطلع کنیم، انتظار داشته باشید که قبل از انتشار عمومی API با تغییرات اساسی مواجه شوید.

نسخه بتا : هیچ تغییر اساسی در این کانال پیش‌بینی نمی‌شود.

برای اطلاع از اطلاعیه‌های رسمی API گوگل آنالیتیکس، در گروه اطلاع‌رسانی API گوگل آنالیتیکس عضو شوید.

مقدمه

رابط برنامه‌نویسی کاربردی مدیریت گوگل آنالیتیکس (Google Analytics Admin API) امکان دسترسی برنامه‌نویسی‌شده به داده‌های پیکربندی گوگل آنالیتیکس را فراهم می‌کند و فقط با ویژگی‌های گوگل آنالیتیکس سازگار است. درباره ویژگی‌های گوگل آنالیتیکس بیشتر بدانید .

شما می‌توانید از API مدیریت گوگل آنالیتیکس برای موارد زیر استفاده کنید:

• ارائه حساب‌های جدید.
• مدیریت حساب‌ها.
• تنظیمات اشتراک‌گذاری داده‌ها را مدیریت کنید.
• خلاصه حساب‌ها را فهرست کنید.
• جستجوی رویدادهای تاریخچه تغییرات.
• مدیریت املاک.
• مدیریت زیر ویژگی‌ها
• جمع‌آوری داده‌های کاربر را تأیید کنید.
• تنظیمات نگهداری داده‌ها را برای یک ویژگی مدیریت کنید.
• مدیریت تنظیمات گوگل سیگنال برای یک ملک (آلفا).
• مدیریت جریان‌ها.
• مدیریت اسرار پروتکل اندازه‌گیری
• مدیریت طرحواره ارزش تبدیل SKAdNetwork (آلفا).
• یک قطعه کد گوگل برای جریان‌های داده وب (آلفا) ایجاد کنید.
• رویدادهای کلیدی را مدیریت کنید.
• مدیریت رویدادهای تبدیل (منسوخ شده).
• مدیریت قوانین ایجاد رویداد (آلفا)
• مدیریت قوانین ویرایش رویداد (آلفا)
• مدیریت ابعاد سفارشی
• مدیریت معیارهای سفارشی
• مدیریت لینک‌ها بین ویژگی‌های گوگل آنالیتیکس و پروژه‌های فایربیس.
• مدیریت لینک‌های بین حساب‌های کاربری گوگل آنالیتیکس و گوگل ادز
• مدیریت پیشنهادها برای پیوند بین یک ویژگی Google Analytics و یک تبلیغ‌کننده Display & Video 360 (آلفا).
• مدیریت لینک‌ها بین یک ویژگی گوگل آنالیتیکس و یک تبلیغ‌کننده Display & Video 360 (آلفا).
• مدیریت لینک‌ها بین یک ویژگی گوگل آنالیتیکس و تبلیغات جستجو ۳۶۰ (آلفا).
• مدیریت لینک‌ها بین یک ویژگی گوگل آنالیتیکس و پروژه بیگ‌کوئری (آلفا).
• مدیریت مجوزهای کاربر برای سلسله مراتب حساب و ویژگی‌های گوگل آنالیتیکس (آلفا).
• گزارش‌های دسترسی به داده‌ها را ایجاد کنید.
• مدیریت مخاطبان (آلفا).
• مدیریت مجموعه داده‌های توسعه‌یافته (آلفا).
• تنظیمات انصراف از فرآیند راه‌اندازی خودکار گوگل آنالیتیکس (آلفا) را مدیریت کنید.

روش‌های موجود

در اینجا روش‌های موجود را معرفی می‌کنیم.

تأمین حساب

• accounts.provisionAccountTicket

این متد فیلد accountTicketId را که باید در URL شرایط خدمات (TOS) گنجانده شود، برمی‌گرداند:

https://analytics.google.com/analytics/web/?provisioningSignup=false#/termsofservice/ACCOUNT_TICKET_ID

به محض اینکه کاربر از آدرس اینترنتی شرایط استفاده (TOS URL) بازدید کند و شرایط خدمات را بپذیرد، ایجاد حساب گوگل آنالیتیکس تکمیل می‌شود. به نمونه‌ی تأمین حساب کاربری مراجعه کنید.

مدیریت حساب‌ها

• accounts.delete
• accounts.get
• accounts.list
• accounts.patch

مدیریت تنظیمات اشتراک‌گذاری داده‌ها

• accounts.getDataSharingSettings

خلاصه حساب‌ها را فهرست کنید

• accountSummaries.list

جستجوی رویدادهای تاریخچه تغییر

• accounts.searchChangeHistoryEvents

مدیریت املاک

• properties.get
• properties.patch
• properties.delete
• properties.list
• properties.create

مدیریت زیرملاک‌ها (آلفا)

• properties.provisionSubproperty

تایید جمع‌آوری داده‌های کاربر

• properties.acknowledgeUserDataCollection

مدیریت تنظیمات نگهداری داده‌ها

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

مدیریت تنظیمات گوگل سیگنالز (آلفا)

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

مدیریت جریان‌های داده

• properties.dataStreams.create
• properties.dataStreams.get
• properties.dataStreams.list
• properties.dataStreams.patch
• properties.dataStreams.delete

مدیریت اسرار پروتکل اندازه‌گیری

• properties.dataStreams.measurementProtocolSecrets.create
• properties.dataStreams.measurementProtocolSecrets.get
• properties.dataStreams.measurementProtocolSecrets.patch
• properties.dataStreams.measurementProtocolSecrets.list
• properties.dataStreams.measurementProtocolSecrets.delete

مدیریت طرحواره ارزش تبدیل SKAdNetwork (آلفا)

• properties.dataStreams.sKAdNetworkConversionValueSchema.get
• properties.dataStreams.sKAdNetworkConversionValueSchema.create
• properties.dataStreams.sKAdNetworkConversionValueSchema.delete
• properties.dataStreams.sKAdNetworkConversionValueSchema.update
• properties.dataStreams.sKAdNetworkConversionValueSchema.list

مدیریت رویدادهای کلیدی

• properties.keyEvents.create
• properties.keyEvents.get
• properties.keyEvents.list
• properties.keyEvents.delete
• properties.keyEvents.patch

مدیریت رویدادهای تبدیل

منسوخ شده: به جای آن از منبع و متدهای KeyEvent استفاده کنید.

• properties.conversionEvents.create
• properties.conversionEvents.get
• properties.conversionEvents.list
• properties.conversionEvents.delete
• properties.conversionEvents.patch

مدیریت قوانین ایجاد رویداد (آلفا)

• properties.dataStreams.eventCreateRules.create
• properties.dataStreams.eventCreateRules.get
• properties.dataStreams.eventCreateRules.list
• properties.dataStreams.eventCreateRules.delete
• properties.dataStreams.eventCreateRules.patch

مدیریت قوانین ویرایش رویداد (آلفا)

• properties.dataStreams.eventEditRules.create
• properties.dataStreams.eventEditRules.get
• properties.dataStreams.eventEditRules.list
• properties.dataStreams.eventEditRules.delete
• properties.dataStreams.eventEditRules.patch
• properties.dataStreams.eventEditRules.reorder

مدیریت ابعاد سفارشی

• properties.customDimensions.create
• properties.customDimensions.get
• properties.customDimensions.list
• properties.customDimensions.patch
• properties.customDimensions.archive

مدیریت معیارهای سفارشی

• properties.customMetrics.create
• properties.customMetrics.get
• properties.customMetrics.list
• properties.customMetrics.patch
• properties.customMetrics.archive

لینک کردن پروژه فایربیس

• properties.firebaseLinks.create
• properties.firebaseLinks.list
• properties.firebaseLinks.delete

لینک کردن حساب گوگل ادز

• properties.googleAdsLinks.create
• properties.googleAdsLinks.list
• properties.googleAdsLinks.patch
• properties.googleAdsLinks.delete

تولید تگ گوگل (آلفا)

• properties.webDataStreams.getGlobalSiteTag

پیشنهادهایی برای پیوند بین یک ویژگی گوگل آنالیتیکس و یک تبلیغ‌کننده Display & Video 360 (آلفا)

• properties.displayVideo360AdvertiserLinkProposals.create
• properties.displayVideo360AdvertiserLinkProposals.approve
• properties.displayVideo360AdvertiserLinkProposals.cancel
• properties.displayVideo360AdvertiserLinkProposals.list
• properties.displayVideo360AdvertiserLinkProposals.get
• properties.displayVideo360AdvertiserLinkProposals.delete

لینک کردن حساب تبلیغ‌کننده‌ی Display & Video 360 (آلفا)

• properties.displayVideo360AdvertiserLinks.create
• properties.displayVideo360AdvertiserLinks.get
• properties.displayVideo360AdvertiserLinks.list
• properties.displayVideo360AdvertiserLinks.delete
• properties.displayVideo360AdvertiserLinks.patch

لینک کردن حساب کاربری در Search Ads 360 (آلفا)

• properties.searchAds360Links.create
• properties.searchAds360Links.delete
• properties.searchAds360Links.patch
• properties.searchAds360Links.list
• properties.searchAds360Links.get

درباره تنظیم ادغام تبلیغات جستجوی آنالیتیکس ۳۶۰ برای یک ویژگی گوگل آنالیتیکس بیشتر بدانید .

اتصال حساب کاربری BigQuery (آلفا)

• properties.bigQueryLinks.create
• properties.bigQueryLinks.delete
• properties.bigQueryLinks.get
• properties.bigQueryLinks.list
• properties.bigQueryLinks.patch

درباره تنظیم خروجی BigQuery برای یک ویژگی Google Analytics بیشتر بدانید .

مدیریت مجوزهای کاربر (آلفا)

• accounts.accessBindings.create
• accounts.accessBindings.delete
• accounts.accessBindings.patch
• accounts.accessBindings.list
• accounts.accessBindings.get
• accounts.accessBindings.batchCreate
• accounts.accessBindings.batchDelete
• accounts.accessBindings.batchUpdate
• accounts.accessBindings.batchGet
• properties.accessBindings.create
• properties.accessBindings.delete
• properties.accessBindings.patch
• properties.accessBindings.list
• properties.accessBindings.get
• properties.accessBindings.batchCreate
• properties.accessBindings.batchDelete
• properties.accessBindings.batchUpdate
• properties.accessBindings.batchGet

گزارش‌های دسترسی به داده‌ها

• properties.runAccessReport

برای اطلاعات بیشتر در مورد این ویژگی، به راهنمای گزارش‌های دسترسی به داده‌ها مراجعه کنید.

مدیریت مخاطب (آلفا)

• properties.audiences.create
• properties.audiences.archive
• properties.audiences.patch
• properties.audiences.list
• properties.audiences.get

درباره مخاطبان در گوگل آنالیتیکس بیشتر بدانید .

مدیریت مجموعه داده‌های توسعه‌یافته (آلفا)

• properties.expandedDataSets.create
• properties.expandedDataSets.delete
• properties.expandedDataSets.patch
• properties.expandedDataSets.list
• properties.expandedDataSets.get

درباره مجموعه داده‌های گسترش‌یافته در گوگل آنالیتیکس ۳۶۰ بیشتر بدانید .

انصراف از فرآیند راه‌اندازی خودکار گوگل آنالیتیکس (آلفا)

• properties.setAutomatedGa4ConfigurationOptOut
• properties.fetchAutomatedGa4ConfigurationOptOut

درباره مدیریت وضعیت انصراف برای فرآیند تنظیم خودکار Google Analytics برای یک ملک UA بیشتر بدانید .