راهنمای ادغام

کلید خصوصی را دریافت کنید

استفاده از رابط Onboarding

برای ادغام با API، باید یک پروژه Google Cloud ایجاد کنید. پس از آن یک حساب کاربری ایجاد کنید و یک کلید خصوصی دریافت کنید. برای شروع روی دکمه زیر کلیک کنید:

ایجاد حساب سرویس

کلید تولید دستی

اگر رابط فوق با مشکل مواجه شد، لطفاً موارد زیر را امتحان کنید:

  1. به Google Cloud Console بروید.
  2. پروژه ای را انتخاب کنید که با استفاده از آن به API دسترسی خواهید داشت.
  3. در منوی IAM & admin در سمت چپ، حساب‌های سرویس را پیدا کنید و یک حساب سرویس جدید ایجاد کنید که مالک پروژه خواهد بود.
  4. پس از ایجاد حساب سرویس، باید یک کلید خصوصی دریافت کنید.

حساب خدمات لیست سفید

هنگامی که یک حساب کاربری ایجاد کردید:

  1. با یک حساب Google که مالک پروژه است، با تیم GTAF در mdp-support@google.com تماس بگیرید . برای دسترسی به نقاط پایانی API اشتراک‌گذاری طرح داده تلفن همراه، حساب Google را در لیست سفید قرار می‌دهیم.
  2. حساب سرویس را با شرکت مخابراتی در پورتال Google ISP مرتبط کنید. شرکت مخابراتی می تواند این ارتباط را با رفتن به API Access ایجاد کند.

کتابخانه را فعال کنید

پس از انجام لیست سفید:

  1. از Google Cloud Console دیدن کنید.
  2. مطمئن شوید که پروژه درست را در نوار منوی بالا انتخاب کرده اید.
  3. API اشتراک‌گذاری طرح داده تلفن همراه را در کتابخانه API فعال کنید.
  4. Preprod Mobile Data Plan Sharing API را در کتابخانه API فعال کنید.

دسترسی به API را آزمایش کنید

برای آزمایش دسترسی خود به روش های جانبی Google:

  1. oauth2l نصب کنید.

  2. یک نشانه دسترسی برای حساب سرویس خود به شرح زیر دریافت کنید. your-service-account-key-file.json فایل کلیدی حساب سرویس شما است.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    توجه داشته باشید که رمز دسترسی حدود یک ساعت دیگر منقضی می شود. قبل از اینکه دوباره دستور بالا را برای یک نشانه دسترسی جدید اجرا کنید، oauth2l reset را اجرا کنید تا کش محلی پاک شود.

  3. فراخوان های آزمایشی را به شرح زیر صادر کنید. YOUR-ASN باید یکی از ASN هایی باشد که هنگام پیکربندی GTAF در طول فرآیند یکپارچه سازی برای ما ارسال می کنید. ACCESS-TOKEN-OBTAINED OBTAINED خروجی دستور oauth2l fetch است. PLAN_STATUS بدنه درخواست PlanStatus است که می‌خواهید به GTAF ارسال کنید.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

تماس های برنامه ای API

دستورالعمل‌های برقراری تماس‌های مجاز با روش‌های جانبی Google را با محدوده OAuth زیر دنبال کنید:

https://www.googleapis.com/auth/dataplansharing

به اشتراک گذاری مالکیت پروژه

در حالی که راه اندازی اولیه شامل یک حساب Google واحد است، ایده خوبی است که گروهی از کاربران مجاز مالکیت پروژه را داشته باشند. در Google Cloud Console ، در زیر منوی IAM و مدیریت، می‌توانید اعضای جدید (از جمله حساب گروه‌های Google) را به عنوان مالک پروژه اضافه کنید.