دسترسی به Google Cloud Search API را پیکربندی کنید

قبل از استفاده مستقیم یا از طریق SDK، باید دسترسی به API جستجوی ابری گوگل (Google Cloud Search API) را پیکربندی کنید. این سند مراحل مورد نیاز برای API جستجوی ابری REST را پوشش می‌دهد.

۱. یک پروژه API ایجاد کنید

برای فعال کردن API، ابتدا یک پروژه Google Cloud ایجاد کنید. این پروژه پایه و اساس استفاده از سرویس‌های Google Cloud، مدیریت APIها و تنظیم مجوزها است.

  1. کنسول گوگل کلود را باز کنید.
  2. روی منوی کشویی پروژه در سمت راست «کنسول گوگل کلود» کلیک کنید و «پروژه جدید» را انتخاب کنید.
  3. در قسمت نام پروژه، یک نام وارد کنید.
  4. (اختیاری) برای تغییر شناسه پروژه، روی ویرایش کلیک کنید. پس از ایجاد، نمی‌توانید این شناسه را تغییر دهید.
  5. برای انتخاب مکان، روی BROWSE کلیک کنید، سپس روی Select کلیک کنید.
  6. روی ایجاد کلیک کنید. پروژه معمولاً ظرف چند دقیقه آماده می‌شود.

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

۲. فعال کردن API

رابط برنامه‌نویسی کاربردی جستجوی ابری (Cloud Search API) را فعال کنید و یک حساب کاربری سرویس برای دریافت اعتبارنامه ایجاد کنید.

  1. پروژه جدید خود را از منوی کشویی در بنر کنسول Google Cloud انتخاب کنید.
  2. روی فعال کردن APIها و خدمات کلیک کنید.
  3. API جستجوی ابری گوگل (Google Cloud Search API) را جستجو و انتخاب کنید.
  4. روی فعال کردن کلیک کنید.

برای اطلاعات بیشتر، به مدیریت APIها در کنسول Google Cloud مراجعه کنید.

۳. ایجاد اعتبارنامه حساب کاربری سرویس

  1. در کنسول گوگل کلود ، در منوی سمت چپ روی Credentials کلیک کنید.
  2. از منوی کشویی «ایجاد اعتبارنامه‌ها»، «حساب سرویس» را انتخاب کنید.
  3. در قسمت نام حساب سرویس، یک نام وارد کنید.
  4. (اختیاری) شناسه حساب سرویس را ویرایش کنید.
  5. روی ایجاد کلیک کنید و ادامه دهید .
  6. برای دسترسی به لیست «حساب‌های سرویس» روی «انجام شد » کلیک کنید.
  7. روی ایمیل حساب سرویس جدید خود کلیک کنید، سپس تب Keys را انتخاب کنید.
  8. روی افزودن کلید > ایجاد کلید جدید کلیک کنید.
  9. JSON را انتخاب کنید و روی Create کلیک کنید. کلید خصوصی روی رایانه شما دانلود می‌شود.

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

۴. ایمیل حساب سرویس را شناسایی کنید

  1. در کنسول گوگل کلود ، پروژه خود را انتخاب کنید.
  2. روی منوی ناوبری > مدیریت و دسترسی > حساب‌های سرویس کلیک کنید.
  3. آدرس ایمیل حساب سرویس خود را یادداشت کنید. برای افزودن منبع داده به Cloud Search به این آدرس نیاز دارید.

۵. پشتیبانی شخص ثالث را راه‌اندازی کنید

قبل از فراخوانی هرگونه API جستجوی ابری دیگر، پشتیبانی شخص ثالث برای جستجوی ابری گوگل را راه‌اندازی کنید.

برای شروع پشتیبانی شخص ثالث:

  1. اعتبارنامه‌های برنامه وب را در پروژه پلتفرم جستجوی ابری خود ایجاد کنید. به بخش ایجاد اعتبارنامه‌ها مراجعه کنید. شما به شناسه کلاینت و رمز کلاینت نیاز دارید.
  2. با استفاده از OAuth 2.0 Playground یک توکن دسترسی دریافت کنید:
    1. روی پیکربندی OAuth 2.0 (آیکون تنظیمات) کلیک کنید و گزینه‌ی «استفاده از اعتبارنامه‌های OAuth خودتان» را علامت بزنید.
    2. شناسه مشتری و رمز مشتری خود را وارد کنید.
    3. در فیلد scopes، آدرس https://www.googleapis.com/auth/cloud_search.settings را وارد کنید و روی Authorize APIs کلیک کنید.
    4. برای توکن‌ها، روی کد مجوز اکسچنج کلیک کنید.

  3. این دستور curl را اجرا کنید و [YOUR_ACCESS_TOKEN] را با توکن خود جایگزین کنید:

    curl --request POST \
'https://cloudsearch.googleapis.com/v1:initializeCustomer' \
  --header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{}' \
  --compressed

    در صورت موفقیت، متن پاسخ شامل یک operation می‌شود. در صورت عدم موفقیت، با پشتیبانی Cloud Search تماس بگیرید.

  4. برای تأیید مقداردهی اولیه از operations.get استفاده کنید:

    curl 'https://cloudsearch.googleapis.com/v1/operations/<var>operation_name</var>?key=[YOUR_API_KEY]' \
--header 'Authorization: Bearer [YOUR_ACCESS_TOKEN]' \
--header 'Accept: application/json' \
--compressed

    مقداردهی اولیه زمانی کامل می‌شود که done true باشد.

مراحل بعدی

  1. برای استفاده از جستجوی ابری با یک مخزن غیر گوگلی مانند Microsoft® SharePoint®، باید یک منبع داده ایجاد کنید. به افزودن منبع داده برای جستجو مراجعه کنید.
  2. پس از تنظیم منبع داده خود، یک طرحواره ایجاد و ثبت کنید تا مشخص شود که Cloud Search چگونه داده‌های شما را نمایش می‌دهد. Cloud Search چگونه باید داده‌ها را نمایش دهد.