این صفحه به شما نشان می دهد که چگونه با استفاده از خط فرمان با Google Analytics Admin API شروع کنید.
مرحله 1. API را فعال کنید
برای ایجاد یک پروژه Cloud Platform جدید، روی این دکمه کلیک کنید، به طور خودکار Google Analytics Admin API را فعال کنید و اعتبارنامه OAuth2 مورد نیاز برای این آموزش را ایجاد کنید:
Google Analytics Admin API را فعال کنیدشما به طور خودکار به کادر گفتگوی پیکربندی اعتبارنامه OAuth2 هدایت خواهید شد. هنگامی که از شما پرسیده شد "از کجا تماس می گیرید؟" را انتخاب کنید "Desktop" را انتخاب کنید.
در گفتگوی حاصل، روی DOWNLOAD CLIENT CONFIGURATION کلیک کنید و فایل credentials.json را در فهرست کاری خود ذخیره کنید.
همچنین، می‌توانید این مراحل را برای ایجاد یک اعتبارنامه OAuth2 در یک پروژه موجود به صورت دستی دنبال کنید.
مرحله 2. Cloud SDK را نصب و مقداردهی اولیه کنید
شما نیاز به ابزار خط فرمان gcloud دارید که روی دستگاه توسعه خود نصب شده باشد.
مرحله 3: یک تماس API برقرار کنید
اکنون می توانید از Google Analytics Admin API برای پرس و جو از ویژگی Google Analytics 4 استفاده کنید.
تصدیق کردن
برای به دست آوردن اعتبار کاربری در این مثال، دستور زیر را اجرا کنید و از مسیر فایل JSON اعتبارنامه دانلود شده در مرحله 1 استفاده کنید:
gcloud auth application-default login \
--scopes=https://www.googleapis.com/auth/analytics.readonly \
--client-id-file=[PATH/TO/credentials.json]
یک گفتگوی رضایت کاربر OAuth در یک پنجره مرورگر جدید باز می شود.
درخواست را ارسال کنید
از curl برای ارسال درخواست به Google Analytics Admin API استفاده کنید. موارد زیر را در خط فرمان خود وارد کنید:
curl \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-H "Content-Type: application/json; charset=utf-8" \
https://analyticsadmin.googleapis.com/v1beta/accounts
دستور curl از دستور gcloud auth application-default print-access-token برای دریافت توکن احراز هویت استفاده می کند.
تبریک می گویم! شما اولین درخواست خود را به Google Analytics Admin API ارسال کرده اید.