یک پروژه توسعه دهنده و تنظیمات حساب را پیکربندی کنید
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
یک پروژه کنسول Actions را پیکربندی کنید
یک پروژه Google Cloud Platform که توسط کنسول کنش‌ها مدیریت می‌شود، به پروژه شما امکان دسترسی به Google Assistant API را می‌دهد. این پروژه میزان استفاده از سهمیه را دنبال می‌کند و معیارهای ارزشمندی را برای درخواست‌های ارسال شده از سخت‌افزار به شما ارائه می‌دهد.
برای فعال کردن دسترسی به Google Assistant API، مراحل زیر را انجام دهید:
Actions Console را باز کنید.
به قسمت Actions Console بروید
روی افزودن/وارد کردن پروژه کلیک کنید.
برای ایجاد یک پروژه جدید، نامی را در کادر نام پروژه وارد کنید و روی ایجاد پروژه کلیک کنید.
اگر قبلاً یک پروژه Google Cloud Platform دارید، می‌توانید آن پروژه را انتخاب کرده و به جای ایجاد یک پروژه جدید، آن را وارد کنید.
اگر پروژه جدیدی ایجاد کرده اید، روی کادر ثبت دستگاه در نزدیکی پایین صفحه کلیک کنید. اگر پروژه ای را که قبلا ایجاد کرده اید وارد کرده اید، این کادر ظاهر نمی شود. برگه ثبت دستگاه (در زیر گزینه های پیشرفته ) را از نوار ناوبری سمت چپ انتخاب کنید.
این برگه مرورگر را باز نگه دارید. از آن برای ثبت مدل دستگاه در مرحله بعد استفاده خواهید کرد.
Google Assistant API را در پروژه ای که انتخاب کرده اید فعال کنید ( شرایط خدمات را ببینید). شما باید این کار را در کنسول Cloud Platform انجام دهید.
API را فعال کنید
روی Enable کلیک کنید.
باید صفحه رضایت OAuth را برای پروژه خود در کنسول Cloud Platform پیکربندی کنید. توجه داشته باشید که بیشتر فیلدهای این صفحه اختیاری هستند.
کنترل های فعالیت را برای حساب خود تنظیم کنید
برای استفاده از Google Assistant، باید داده‌های فعالیت خاصی را با Google به اشتراک بگذارید. دستیار Google برای عملکرد صحیح به این داده ها نیاز دارد. این مختص SDK نیست. برای اشتراک‌گذاری این داده‌ها، اگر قبلاً ندارید، یک حساب Google ایجاد کنید.
صفحه Activity Controls را برای حساب Google که می‌خواهید با Assistant استفاده کنید، باز کنید. می توانید از هر حساب Google استفاده کنید—نیازی نیست که حساب توسعه دهنده شما باشد.
اطمینان حاصل کنید که سوئیچ های زیر فعال هستند (آبی) :
- فعالیت وب و برنامه
- علاوه بر این، حتماً کادر «شامل سابقه و فعالیت Chrome» را از سایت‌ها، برنامه‌ها و دستگاه‌هایی که از خدمات Google استفاده می‌کنند، انتخاب کنید.
- اطلاعات دستگاه
- فعالیت صوتی و صوتی
مرحله بعدی
مدل دستگاه را ثبت کنید
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-24 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eAn Actions Console project provides access to the Google Assistant API, tracks quota usage, and provides valuable metrics.\u003c/p\u003e\n"],["\u003cp\u003eTo enable Assistant API access, you need to create or import a project in the Actions Console and enable the necessary API.\u003c/p\u003e\n"],["\u003cp\u003eFor the Assistant to function, ensure your Google Account's "Web & App Activity," "Device Information," and "Voice & Audio Activity" are enabled within the Activity Controls.\u003c/p\u003e\n"],["\u003cp\u003eBefore using the Assistant, be sure to register a Device Model in the Actions Console to associate with your project.\u003c/p\u003e\n"]]],["To begin, open the Actions Console and add or import a Google Cloud Platform project. If creating a new project, enter a name and proceed to \"Device registration\"; if importing, go directly to the \"Device registration\" tab. Then, enable the Google Assistant API in the Cloud Platform Console. Lastly, configure the OAuth consent screen for your project in the Cloud Platform Console. Ensure your Google account's activity controls are enabled for Web & App, Device Information, and Voice & Audio activity.\n"],null,["# Configure a Developer Project and Account Settings\n\nConfigure an Actions Console project\n------------------------------------\n\nA Google Cloud Platform project, managed by the Actions Console, gives your\nproject access to the Google Assistant API. The project tracks quota usage and\ngives you valuable metrics for the requests made from your hardware.\n\nTo enable access to the Google Assistant API, perform the following steps:\n\n1. Open the Actions Console.\n\n [Go\n to the Actions Console](https://console.actions.google.com/)\n2. Click **Add/import project**.\n\n3. To create a new project, enter a name in the **Project name** box and click\n **CREATE PROJECT**.\n\n \u003cbr /\u003e\n\n If you already have an existing Google Cloud Platform project, you can select that\n project and import it rather than creating a new one.\n\n4.\n If you created a new project, click the **Device registration** box near the\n bottom of the page. If you imported a previously-created project, this box\n does not appear; select the **Device registration** tab (under\n **ADVANCED OPTIONS**) from the left navbar.\n\n Keep this browser tab open. You will use it to register a device model in\n a later step.\n5. Enable the Google Assistant API on the project you selected (see the [Terms\n of Service](/assistant/sdk/terms-of-service)). You need to do this in the\n Cloud Platform Console.\n\n [Enable\n the API](https://console.developers.google.com/apis/api/embeddedassistant.googleapis.com/overview)\n\n Click **Enable**.\n6. You must configure the [OAuth consent\n screen](https://console.developers.google.com/apis/credentials/consent)\n for your project in the Cloud Platform Console. Note that most fields on\n this page are optional.\n\n\nSet activity controls for your account\n--------------------------------------\n\nIn order to use the Google Assistant, you must share certain activity data with\nGoogle. The Google Assistant needs this data to function properly; this is not\nspecific to the SDK. To share this data, create a\n[Google account](https://support.google.com/accounts/answer/27441)\nif you don't already have one.\n\nOpen the [Activity Controls page](https://myaccount.google.com/activitycontrols)\nfor the Google account that you want to use with the Assistant. You can use any\nGoogle account---it does not need to be your developer account.\n\n**Ensure the following toggle switches are enabled (blue)**:\n\n- Web \\& App Activity\n - In addition, be sure to select the **Include Chrome history and activity\n from sites, apps, and devices that use Google services** checkbox.\n- Device Information\n- Voice \\& Audio Activity\n\nNext step\n---------\n\n[Register the Device Model](/assistant/sdk/guides/service/python/embed/register-device)"]]
