نمای کلی Google Analytics Admin API

خلاصه: این سند نمای کلی سطح بالایی از Google Analytics Admin API نسخه ۱.۰ ارائه می‌دهد.

مقدمه

«میانای برنامه‌سازی کاربردی سرپرست Google Analytics» امکان دسترسی برنامه‌ریزی‌شده به داده‌های پیکربندی Google Analytics را فراهم می‌کند و فقط با دارایی‌های Google Analytics سازگار است. درباره دارایی‌های Google Analytics بیشتر بدانید.

می‌توانید از Google Analytics Admin API برای موارد زیر استفاده کنید:

• حساب‌های جدید را آماده کنید.
• مدیریت حساب‌ها.
• تنظیمات هم‌رسانی داده را مدیریت کنید.
• خلاصه حساب‌ها را فهرست کنید.
• رویدادهای سابقه تغییر را جستجو کنید.
• مدیریت دارایی‌ها.
• مدیریت زیرمجموعه ویژگی‌ها.
• جمع‌آوری داده‌های کاربر را تصدیق کنید.
• ارسال درخواست‌های حذف کاربر برای دارایی (آلفا).
• تنظیمات نگهداری داده‌ها را برای دارایی مدیریت کنید.
• مدیریت تنظیمات Google Signals برای دارایی (آلفا).
• جاری‌سازی‌ها را مدیریت کنید.
• مدیریت کردن کدهای مخفی Measurement Protocol.
• مدیریت طرح‌واره مقدار تبدیل SKAdNetwork (نسخه آلفا).
• تولید تکه‌کد برچسب Google برای جریان‌های داده وب (آلفا).
• رویدادهای کلیدی را مدیریت کنید.
• مدیریت رویدادهای تبدیل (منسوخ‌شده).
• مدیریت قوانین ایجاد رویداد (آلفا)
• مدیریت قوانین ویرایش رویداد (آلفا)
• مدیریت ابعاد سفارشی.
• مدیریت سنجه‌های سفارشی.
• پیوندها بین دارایی‌های Google Analytics و پروژه‌های Firebase را مدیریت کنید.
• مدیریت کردن پیوندها بین دارایی‌های Google Analytics و حساب‌های Google Ads.
• مدیریت پیشنهادهای پیوند بین دارایی Google Analytics و تبلیغ‌کننده Display & Video 360 (آلفا).
• مدیریت پیوندهای بین دارایی Google Analytics و آگهی‌دهنده Display & Video 360 (آلفا).
• مدیریت کردن پیوندهای بین دارایی Google Analytics و Search Ads 360 (آلفا).
• مدیریت پیوندها بین دارایی Google Analytics و پروژه BigQuery (نسخه آلفا).
• مدیریت اجازه‌های کاربر برای سلسله‌مراتب حساب و دارایی‌های Google Analytics (آلفا).
• تولید گزارش‌های دسترسی به داده‌ها.
• مدیریت مخاطبان (آلفا).
• مدیریت مجموعه‌های داده گسترش‌یافته (آلفا).
• مدیریت کردن گزارمان‌های داده‌های گزارش‌دهی (نسخه آلفا).

روش‌های دردسترس

در اینجا روش‌های دردسترس آمده است.

تأمین حساب

• accounts.provisionAccountTicket

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

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

وقتی کاربر از نشانی وب «شرایط خدمات» بازدید کند و «شرایط خدمات» را بپذیرد، ایجاد حساب Google Analytics تکمیل خواهد شد. نمونه آماده‌سازی حساب را ببینید.

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

• 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.submitUserDeletion

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

• properties.getDataRetentionSettings
• properties.updateDataRetentionSettings

مدیریت تنظیمات «سیگنال‌های Google» (آلفا)

• properties.getGoogleSignalsSettings
• properties.updateGoogleSignalsSettings

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

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

مدیریت رمزهای Measurement Protocol

• 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

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

• 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

پیونددهی پروژه Firebase

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

پیوند کردن حساب Google Ads

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

تولید برچسب Google (آلفا)

• properties.webDataStreams.getGlobalSiteTag

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

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

پیوند حساب تبلیغ‌کننده «ویدیو ۳۶۰» و «شبکه تبلیغات» (نسخه آلفا)

• 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

درباره راه‌اندازی ادغام Analytics Search Ads 360 برای دارایی Google Analytics بیشتر بدانید.

پیوند دادن حساب 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

درباره مخاطبان در Google Analytics بیشتر بدانید.

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

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

درباره «مجموعه‌های داده گسترده» در Google Analytics 360 بیشتر بدانید.

مدیریت حاشیه‌نویسی‌های داده‌های گزارش‌دهی (آلفا)

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

درباره حاشیه‌نویسی‌ها برای منابع ReportingDataAnnotation در Google Analytics بیشتر بدانید.