API Quickstart با استفاده از خط فرمان

این صفحه به شما نشان می دهد که چگونه با استفاده از خط فرمان با Google Analytics Admin API شروع کنید.

مرحله 1. API را فعال کنید

برای ایجاد یک پروژه جدید Google Cloud روی دکمه زیر کلیک کنید، به طور خودکار Google Analytics Admin API را فعال کنید و اعتبارنامه OAuth2 مورد نیاز برای این آموزش را ایجاد کنید:

Google Analytics Admin API را فعال کنید

شما به طور خودکار به کادر گفتگوی پیکربندی اعتبارنامه OAuth2 هدایت خواهید شد. وقتی گفتگو می پرسد از کجا تماس می گیرید؟ دسکتاپ را انتخاب کنید.

در گفتگوی بعدی، روی DOWNLOAD CLIENT CONFIGURATION کلیک کنید و فایل credentials.json را در فهرست کاری خود ذخیره کنید.

همچنین، می‌توانید این مراحل را برای ایجاد یک اعتبارنامه OAuth2 در یک پروژه موجود به صورت دستی دنبال کنید.

مرحله 2. Cloud SDK را نصب و مقداردهی اولیه کنید

شما نیاز به ابزار خط فرمان gcloud دارید که روی دستگاه توسعه خود نصب شده باشد.

مرحله 3: یک تماس API برقرار کنید

اکنون می توانید از Google Analytics Admin API برای پرس و جو از ویژگی Google Analytics استفاده کنید.

احراز هویت

برای به دست آوردن اعتبار کاربری در این مثال، دستور زیر را اجرا کنید و از مسیر فایل 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 برای دریافت توکن احراز هویت استفاده می کند.