Search Ads 360 API به همه درخواست‌ها نیاز دارد که یک نشانه دسترسی OAuth 2.0 را برای احراز هویت مشخص کنند. می‌توانید از هر گردش کار احراز هویت استاندارد OAuth 2.0 پیروی کنید تا رمز را تولید کنید و آن را به Search Ads 360 API ارسال کنید. ما گردش کار شرح داده شده در زیر را توصیه می کنیم زیرا برای آپلودهای تبدیل کاملاً خودکار و بارگیری گزارش مناسب است.
برای جایگزین‌های گردش کار شرح داده شده در زیر، به استفاده از OAuth 2.0 برای برنامه‌های نصب شده یا استفاده از OAuth 2.0 برای برنامه‌های سرور به سرور مراجعه کنید. اگر از یک گردش کار جایگزین استفاده می کنید، هنگام درخواست کد مجوز OAuth 2.0، مقدار زیر را به عنوان پارامتر scope مشخص کنید:
https://www.googleapis.com/auth/doubleclicksearch
اگر مسیر سرور به سرور را دنبال می کنید، حساب سرویس را به عنوان کاربر Search Ads 360 اضافه کنید.
گردش کار مجوز توصیه شده
- به کنسول API Google بروید و پروژه خود را انتخاب کنید.
اگر قبلاً یک پروژه Google API Console و اعتبارنامه OAuth ایجاد نکرده‌اید، دستورالعمل‌های ایجاد پروژه Google API Console و اعتبارنامه OAuth را برای مشتری خود دنبال کنید.
برای پیدا کردن شناسه مشتری OAuth و راز پروژه خود، موارد زیر را انجام دهید:
- صفحه اعتبارنامه را باز کنید.
- در ستون Name ، روی نام مشتری OAuth خود کلیک کنید.
- شناسه مشتری و راز در صفحه ذکر شده است.
- یک مرورگر وب باز کنید و با یک حساب Google که مجوز دسترسی به داده‌های Search Ads 360 را دارد، وارد Google شوید .
این همان حساب Google است که مشتری API شما برای احراز هویت با Search Ads 360 استفاده می‌کند. اگر دارنده حساب Google شرکت شما را ترک کند و دسترسی Search Ads 360 را از حساب حذف کنید، باید این گردش کار مجوز را تکرار کنید و حساب Google دیگری را مشخص کنید. .
- با فراخوانی اسکریپت ابزار Search Ads 360 به شرح زیر، یک نشانه به‌روزرسانی دریافت کنید:
sa360Api.py --loginاین اسکریپت شما را از طریق فرآیند استفاده از شناسه مشتری Oauth و مخفی برای به دست آوردن یک توکن به‌روزرسانی می‌برد. نشانه تازه‌سازی فقط برای حساب Google که در مرحله قبل به آن وارد شده‌اید معتبر است.
به عنوان بخشی از این فرآیند، اسکریپت یک URL تولید می کند و به شما دستور می دهد که URL را در یک مرورگر وب مشاهده کنید.
وقتی مرورگر از شما می‌خواهد که به مشتری OAuth اجازه دسترسی به داده‌های Search Ads 360 را بدهید، مطمئن شوید که حساب Google که قبلاً به آن وارد شده‌اید ظاهر شود. (اگر به چندین حساب Google وارد شده باشید، ممکن است با یک حساب دیگر مواجه شوید.)
در پایان فرآیند، اسکریپت
sa360Api.pyیک رشته محدود شده با کاما را خروجی می دهد. مقدار اول شناسه مشتری است که شما ارائه کرده اید، مقدار دوم رمز مشتری است که ارائه کرده اید و مقدار سوم رمز تجدید است. در خروجی مثال زیر، نشانه رفرش با متن پررنگ است:
123456789123.apps.googleusercontent.com,ABCDEFGHIJKLMNOPQR_abcdef, 1/HIJklM01OPQR23NOP456rst890uvw- شناسه سرویس گیرنده، رمز سرویس گیرنده، و توکن رفرش را در یک پایگاه داده پشتیبان یا مکان امن دیگری که برای برنامه شما قابل دسترسی است ذخیره کنید.
اگر می‌خواهید از
sa360Api.pyبرای ارسال نمونه درخواست‌های JSON به Search Ads 360 API استفاده کنید، کل رشته محدود شده با کاما را در یک مکان مناسب نگه دارید. هر بار که اسکریپت را فراخوانی می کنید، کل رشته را به عنوان پارامتر ارسال می کنید. - کدی را به برنامه خود اضافه کنید که کارهای زیر را انجام می دهد:
- از شناسه سرویس گیرنده، رمز سرویس گیرنده، و نشانه رفرش استفاده کنید تا یک نشانه دسترسی جدید OAuth 2.0 به دست آورید.
- با استفاده از رمز دسترسی تازه، درخواست‌ها را به Search Ads 360 API ارسال کنید.
اگر از کتابخانه های سرویس گیرنده استفاده می کنید، بخش بعدی، راه اندازی برنامه ، نحوه افزودن این کد مجوز را به برنامه خود توضیح می دهد.
اگر از یکی از کتابخانه‌های سرویس گیرنده استفاده نمی‌کنید، برای دریافت پیشنهادات مربوط به دریافت رمز دسترسی جدید ، به استفاده از OAuth 2.0 برای برنامه‌های نصب شده مراجعه کنید.