این ویژگی به شما امکان میدهد سطوح دسترسی API شما توسط یک سازمان Google Cloud مدیریت شود و مزایای زیر را در اختیار شما قرار میدهد:
دیگر نیازی به ایمن کردن توکنهای توسعهدهنده نیست: دسترسی به API از طریق سازمان Google Cloud مدیریت میشود، بنابراین دیگر لازم نیست نگران ایمنسازی توکنهای توسعهدهنده یا افشای آن باشید. میتوانید از ارسال توکن توسعهدهنده خود در تماسهای API خود صرفنظر کنید، اگرچه همچنان نیاز به ارسال نشانه دسترسی دارید.
پروژههای Google API Console جداگانه را برای برنامههای مختلف حفظ کنید: هر پروژه پیوند داده شده تحت سازمان Google Cloud، سطح دسترسی API سازمان را به ارث میبرد. این به شما امکان میدهد چندین پروژه Google API Console را تحت این سازمان برای اهدافی مانند مدیریت پروژه ریز، پروژههای جداگانه برای برنامههای مختلف و چندین پروژه Google API Console برای اعضای تیم خود ایجاد کنید.
نظارت و مدیریت سهمیه دقیق تر : می توانید استفاده از API پروژه های فردی یا استفاده از API را کنترل کنید.
پیش نیازها
توکن تایید شده توسعه دهنده
برای استفاده از این گزینه باید قبلاً یک توکن توسعه دهنده تأیید شده داشته باشید. میتوانید توکن توسعهدهنده موجود را در صفحه API Center حساب مدیر Google Ads خود پیدا کنید. وارد شوید ، سپس به ToOLS & SETTINGS > SETUP > API Center بروید.
یک سازمان Google Cloud
Google Ads API توکن توسعه دهنده شما را به یک سازمان Google Cloud مرتبط می کند و از آن برای تعیین سطوح دسترسی API شما استفاده می کند. راه های مختلفی برای ایجاد یک سازمان Google Cloud وجود دارد.
سناریو مراحل شما یک مشتری موجود Google Workspace یا Google Cloud Identity هستید این احتمال وجود دارد که شما از قبل صاحب یک منبع سازمان باشید. در صورت نیاز می توانید آن را بررسی کرده و ایجاد کنید. شما از Google Workspace یا Google Cloud Identity استفاده نمی کنید برای نسخه رایگان Google Cloud Identity ثبت نام کنید. سپس منبع سازمان خود را ایجاد کنید . هیچ یک از گزینه های قبلی برای شما کار نمی کند هنگام ثبت نام در پایلوت سناریوی خود را توضیح دهید و از Google بخواهید یک منبع سازمانی برای شما ایجاد کند. Google بدون هیچ هزینه ای مالک و مدیریت این منبع سازمان خواهد بود. پروژه های Google API Console خود را برای برنامه آزمایشی آماده کنید
باید پروژههای Google API Console را که با Google Ads API برای برنامه آزمایشی استفاده میکنید به شرح زیر آماده کنید:
سناریو مراحل شما قبلاً صاحب یک سازمان Google Cloud هستید یا در مرحله قبل یک سازمان ایجاد کرده اید مطمئن شوید که تمام پروژههای Google API Console که در آنها API Google Ads را فعال کردهاید، تحت این سازمان هستند. اگر اینطور نیست، آن را تحت سازمان انتقال دهید . اگر یک مشتری Google Workspace یا Google Cloud Identity هستید، احتمالاً پروژههای Google API Console در حال حاضر تحت سازمان شما هستند، بنابراین میتوانید از این مرحله رد شوید.
شما صاحب یک سازمان Google Cloud نیستید و در مرحله قبل نتوانستید آن را ایجاد کنید مطمئن شوید که هم در حساب مدیر Google Ads API و هم در پروژه Google API Console خود کاربر سرپرست هستید. برای انجام مراحل اضافی پس از تایید درخواست خلبانی به این مجوز نیاز دارید. یک ایمیل تماس API به روز
مطمئن شوید که ایمیل تماس Google Ads API شما به روز است. جزئیات تماس API شما در صفحه API Center حساب مدیر Google Ads API فهرست شده است. وارد شوید ، سپس به ToOLS & SETTINGS > SETUP > API Center بروید.
برای برنامه آزمایشی ثبت نام کنید
برای برنامه آزمایشی ثبت نام کنید . سپس تیم Google Compliance درخواست شما را بررسی میکند و آدرس ایمیل تماس API شما را با وضعیت تأیید و جزئیات بیشتر ایمیل میکند.
اگر از Google درخواست کردهاید که یک سازمان Google Cloud برای شما ایجاد کند، چند مرحله دیگر وجود دارد:
Google یک منبع سازمان Cloud متعلق به Google برای شما ایجاد خواهد کرد. به همه سرپرستان حساب مدیر Google Ads API شما، نقش
roles/resourcemanager.projectCreator
در سازمان تازه ایجاد شده اعطا می شود.Google آدرس ایمیل تماس API شما را با جزئیات منبع سازمان تازه ایجاد شده ایمیل خواهد کرد.
باید به حساب Google API Console خود وارد شوید و دستورالعملها را دنبال کنید تا پروژه Google API Console خود را تحت سازمان جدید منتقل کنید .
به ایمیل پاسخ دهید تا به Google اطلاع دهید که پروژه های شما تحت سازمان جدید منتقل شده اند.
تیم Google Compliance درخواست شما را بررسی میکند و آدرس ایمیل تماس API شما را با وضعیت تأیید و جزئیات بیشتر ایمیل میکند.
درخواست های API خود را تغییر دهید
میتوانید برنامه خود را طوری تغییر دهید که هنگام برقراری تماسهای API، هدر developer-token
ارسال نشود. این یک مرحله اختیاری است اما توصیه می شود. اگر در برنامه آزمایشی هستید، سرور API Google Ads اگر به عنوان بخشی از درخواست های API ارسال شود developer-token
نادیده می گیرد.
جاوا
به زودی!
دات نت
نسخه 17.1.0 یا جدیدتر کتابخانه Google Ads API .NET را دانلود و نصب کنید.
سپس کد خود را به صورت زیر تغییر دهید:
// Create a client.
GoogleAdsClient client = new GoogleAdsClient();
// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;
// Make the API calls.
...
PHP
به زودی!
پایتون
به زودی!
روبی
به زودی!
پرل
به زودی!
سرویس گیرنده HTTP (REST)
هدر developer-token
در درخواست های HTTP خود حذف کنید:
curl -i -X POST https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/googleAds:searchStream \
-H "Content-Type: application/json" \
-H "Authorization: Bearer ACCESS_TOKEN" \
-H "login-customer-id: LOGIN_CUSTOMER_ID" \
--data-binary "@query.json"
سوالات متداول
آیا این تغییر به این معنی است که برای استفاده از Google Ads API باید مشتری Google Workspace یا Google Cloud باشم؟
خیر. شما به یک سازمان Google Cloud نیاز دارید که از طرق مختلف قابل دستیابی باشد. این نیاز شبیه به نیاز شما به پروژه کنسول API Google برای استفاده از Google Ads API است.
باید سطوح دسترسی API خود را تغییر دهم. چگونه می توانم این کار را انجام دهم؟
برای درخواست هرگونه تغییر در سطوح دسترسی API فعلاً باید از مرکز API استفاده کنید.
آیا زمان توقفی برای شرکت در این خلبان وجود دارد؟
نه، وجود ندارد. Google Ads API پس از تأیید به طور خودکار شروع به استفاده از سطوح دسترسی API در سطح سازمان می کند.
چقدر برای شرکت در این پایلوت نیاز است؟
انتظار حداقل تغییرات کد را داشته باشید. اکثر توسعه دهندگان باید بتوانند تغییرات برنامه خود را در کمتر از 30 دقیقه تکمیل کنند.
آیا در صورت شرکت در این خلبان هزینه ای از من دریافت می شود؟
به طور کلی، خیر، در صورت شرکت در این خلبان هزینه ای از شما دریافت نمی شود. Google Ads API بدون هزینه ارائه میشود و Google هیچ تغییری در مدل قیمتگذاری Google Ads API ایجاد نمیکند.
سناریوهای ممکن برای به دست آوردن یک سازمان Google Cloud به شرح زیر است:
شما یک مشتری موجود Google Workspace یا Google Cloud Identity هستید :
برای استفاده منظم از آن محصولات طبق معمول هزینه از شما کسر می شود. برای ایجاد یک سازمان Google Cloud به منظور شرکت در این آزمایشی هزینه ای از شما دریافت نمی شود.
شما یک حساب نسخه رایگان Google Cloud Identity ایجاد کردید :
هنگام ثبت نام برای حساب نسخه رایگان Google Cloud Identity یا ایجاد یک سازمان Google Cloud به منظور شرکت در این آزمایشی هزینه ای از شما دریافت نمی شود.
Google یک منبع سازمان Cloud برای شما ایجاد کرد :
این یک منبع داخلی سازمان Cloud تحت مدیریت Google است، بنابراین در نتیجه هزینهای از شما کسر نمیشود.
من چندین توکن توسعه دهنده برای ابزارهای مختلف دارم. این خلبان چه تاثیری بر من می گذارد؟
این مورد استفاده پشتیبانی نمیشود، بنابراین نمیتوانید در این آزمایشی شرکت کنید.
آیا این روی مجوزهای API موجود برای حسابهایی که با استفاده از Google Ads API مدیریت میکنم، تأثیر میگذارد؟
خیر، این تغییر بر هیچ مجوز API موجود در حسابهای Google Ads که با استفاده از Google Ads API مدیریت میکنید، تأثیری نمیگذارد.
من در این پایلوت شرکت کردم و مشکل یا بازخوردی دارم. چگونه با پشتیبانی تماس بگیرم؟
با استفاده از صفحه پشتیبانی فنی API با تیم Google Ads API تماس بگیرید و ماهیت مشکل خود را توضیح دهید. در صورت امکان جزئیاتی مانند شناسه سازمان و گزارش درخواست و پاسخ را درج کنید.