این ویژگی به شما امکان میدهد سطوح دسترسی API خود را توسط یک سازمان Google Cloud مدیریت کنید و مزایای زیر را برای شما به ارمغان میآورد:
دیگر نیازی به ایمنسازی توکنهای توسعهدهنده نیست: دسترسی به API از طریق سازمان Google Cloud مدیریت میشود، بنابراین دیگر نیازی به نگرانی در مورد ایمنسازی توکنهای توسعهدهنده یا افشای آنها ندارید. میتوانید از ارسال توکن توسعهدهنده خود در فراخوانیهای API خود صرف نظر کنید، اگرچه هنوز به ارسال توکن دسترسی نیاز دارید.
حفظ پروژههای جداگانه کنسول API گوگل برای برنامههای مختلف: هر پروژهای که تحت سازمان Google Cloud لینک شده است، سطح دسترسی API آن سازمان را به ارث میبرد. این به شما امکان میدهد چندین پروژه کنسول API گوگل را تحت این سازمان برای اهدافی مانند مدیریت دقیق پروژه، پروژههای جداگانه برای برنامههای مختلف و چندین پروژه کنسول API گوگل برای اعضای تیم خود ایجاد کنید.
نظارت و مدیریت سهمیه دقیقتر : میتوانید میزان استفاده از API در پروژههای منفرد را رصد کنید یا میزان استفاده از API را محدود کنید .
پیشنیازها
یک توکن توسعهدهنده تأیید شده
برای استفاده از این گزینه، باید از قبل یک توکن توسعهدهنده تأیید شده داشته باشید. میتوانید یک توکن توسعهدهنده موجود را در مرکز API در حساب مدیریت تبلیغات گوگل خود پیدا کنید. وارد شوید ، سپس به قسمت مدیریت > مرکز API بروید. در مرکز API، به قسمت دسترسی به API > توکن توسعهدهنده بروید.
یک سازمان ابری گوگل
رابط برنامهنویسی کاربردی گوگل ادز، توکن توسعهدهنده شما را به یک سازمان گوگل کلود مرتبط میکند و از آن برای تعیین سطوح دسترسی API شما استفاده میکند. روشهای مختلفی برای ایجاد یک سازمان گوگل کلود وجود دارد.
سناریو مراحل شما از قبل مشتری Google Workspace یا Google Cloud Identity هستید احتمالاً شما از قبل یک منبع سازمانی دارید. در صورت لزوم میتوانید آن را بررسی و ایجاد کنید. شما از Google Workspace یا Google Cloud Identity استفاده نمیکنید برای نسخه رایگان Google Cloud Identity ثبت نام کنید. سپس منبع سازمانی خود را ایجاد کنید . هیچ کدام از گزینه های قبلی برای شما مناسب نیست سناریوی خود را هنگام ثبت نام در طرح آزمایشی توضیح دهید و از گوگل بخواهید که یک منبع سازمانی برای شما ایجاد کند. گوگل مالکیت و مدیریت این منبع سازمانی را بدون هیچ هزینهای بر عهده خواهد داشت. پروژههای کنسول API گوگل خود را برای برنامه آزمایشی آماده کنید
شما باید پروژههای کنسول API گوگل را که با API گوگل ادز برای برنامه آزمایشی استفاده میکنید، به شرح زیر آماده کنید:
سناریو مراحل شما از قبل یک سازمان Google Cloud دارید یا در مرحله قبل یکی ایجاد کردهاید مطمئن شوید که تمام پروژههای کنسول API گوگل که در آنها API تبلیغات گوگل را فعال کردهاید، تحت این سازمان هستند. اگر اینطور نیست، آن را تحت این سازمان منتقل کنید . اگر از مشتریان فعلی Google Workspace یا Google Cloud Identity هستید، احتمالاً پروژههای Google API Console از قبل در سازمان شما وجود دارند، بنابراین میتوانید از این مرحله صرف نظر کنید.
شما صاحب یک سازمان Google Cloud نیستید و در مرحله قبل هم نتوانستید یکی ایجاد کنید. مطمئن شوید که هم در حساب کاربری مدیریت API گوگل ادز و هم در پروژه کنسول API گوگل خود، کاربر مدیر هستید. برای انجام مراحل اضافی پس از تأیید برنامه آزمایشی خود، به این مجوز نیاز دارید. یک ایمیل تماس API بهروز
مطمئن شوید که ایمیل تماس با API گوگل ادز شما بهروز است. اطلاعات تماس API شما در صفحه مرکز API حساب مدیریت API گوگل ادز شما فهرست شده است. وارد سیستم شوید ، سپس به ابزارها و تنظیمات > تنظیمات > مرکز API بروید.
ثبت نام در برنامه آزمایشی
برای برنامه آزمایشی ثبت نام کنید . تیم انطباق گوگل درخواست شما را بررسی کرده و آدرس ایمیل رابط برنامهنویسی کاربردی (API) شما را به همراه وضعیت تأیید و جزئیات بیشتر ایمیل خواهد کرد.
اگر از گوگل درخواست کردهاید که یک سازمان ابری گوگل برای شما ایجاد کند، چند مرحله اضافی وجود دارد:
گوگل یک منبع سازمانی ابری متعلق به گوگل برای شما ایجاد خواهد کرد. به همه مدیران حساب کاربری مدیریت API تبلیغات گوگل شما، نقش
roles/resourcemanager.projectCreatorدر سازمان تازه ایجاد شده اعطا خواهد شد.گوگل آدرس ایمیل رابط برنامهنویسی کاربردی (API) شما را به همراه جزئیات منبع سازمانی تازه ایجاد شده، ایمیل خواهد کرد.
شما باید وارد حساب کاربری Google API Console خود شوید و دستورالعملها را برای انتقال پروژه Google API Console خود تحت سازمان جدید دنبال کنید.
به ایمیل پاسخ دهید تا به گوگل اطلاع دهید که پروژههای شما تحت سازمان جدید منتقل شدهاند.
تیم انطباق گوگل درخواست شما را بررسی کرده و وضعیت تأیید و جزئیات بیشتر را به آدرس ایمیل رابط برنامهنویسی کاربردی (API) شما ارسال خواهد کرد.
درخواستهای API خود را اصلاح کنید
شما میتوانید برنامه خود را طوری تغییر دهید که هنگام فراخوانی API، ارسال هدر developer-token را متوقف کند. این یک مرحله اختیاری است اما توصیه میشود. اگر در برنامه آزمایشی هستید، سرور Google Ads API، اگر developer-token به عنوان بخشی از درخواستهای API ارسال شود، آن را نادیده میگیرد.
جاوا
به زودی!
دات نت
نسخه ۱۷.۱.۰ یا جدیدتر از کتابخانه Google Ads API .NET را دانلود و نصب کنید.
در مرحله بعد، کد خود را به صورت زیر تغییر دهید:
// Create a client.
GoogleAdsClient client = new GoogleAdsClient();
// Opt into the pilot.
client.Config.UseCloudOrgForApiAccess = true;
// Make the API calls.
...
پی اچ پی
به زودی!
پایتون
به زودی!
روبی
به زودی!
پرل
به زودی!
کلاینت HTTP (REST)
هدر developer-token را در درخواستهای HTTP خود حذف کنید:
curl -i -X POST https://googleads.googleapis.com/v24/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"سوالات متداول
در اینجا به برخی از سوالات متداول در مورد سطوح دسترسی مدیریت شده توسط ابر اشاره میکنیم.
آیا این تغییر به این معنی است که برای استفاده از API تبلیغات گوگل، باید مشتری Google Workspace یا Google Cloud باشم؟
خیر. شما به یک سازمان Google Cloud نیاز دارید که میتوان آن را از چندین طریق به دست آورد. این نیاز مشابه نیاز شما به یک پروژه Google API Console برای استفاده از Google Ads API در حال حاضر است.
من باید سطح دسترسی API خود را تغییر دهم. چگونه میتوانم این کار را انجام دهم؟
فعلاً باید برای درخواست هرگونه تغییر در سطوح دسترسی API ، به استفاده از مرکز API ادامه دهید.
آیا برای شرکت در این طرح آزمایشی، زمان استراحتی وجود دارد؟
خیر، وجود ندارد. API تبلیغات گوگل پس از تأیید، بهطور خودکار شروع به استفاده از سطوح دسترسی API در سطح سازمان خواهد کرد.
شرکت در این طرح آزمایشی چقدر تلاش میطلبد؟
انتظار تغییرات حداقلی در کد را داشته باشید. اکثر توسعهدهندگان باید بتوانند تغییرات برنامه خود را در کمتر از 30 دقیقه انجام دهند.
آیا در صورت انتخاب این طرح آزمایشی، هزینهای از من دریافت میشود؟
به طور کلی، خیر، اگر در این طرح آزمایشی شرکت کنید، هیچ هزینهای از شما دریافت نمیشود. API تبلیغات گوگل (Google Ads API) رایگان ارائه میشود و گوگل هیچ تغییری در مدل قیمتگذاری API تبلیغات گوگل ایجاد نمیکند.
سناریوهای ممکن برای به دست آوردن یک سازمان Google Cloud به شرح زیر است:
شما از قبل مشتری Google Workspace یا Google Cloud Identity هستید :
طبق معمول برای هرگونه استفاده منظم از این محصولات از شما هزینه دریافت میشود. برای ایجاد یک سازمان Google Cloud به منظور شرکت در این طرح آزمایشی، هزینهای از شما دریافت نخواهد شد.
شما یک حساب کاربری نسخه رایگان Google Cloud Identity ایجاد کردید :
هنگام ثبت نام در حساب کاربری نسخه رایگان Google Cloud Identity یا برای ایجاد یک سازمان Google Cloud به منظور شرکت در این طرح آزمایشی، هیچ هزینهای از شما دریافت نخواهد شد.
گوگل یک منبع سازمانی ابری برای شما ایجاد کرده است :
این یک منبع سازمانی ابری داخلی تحت مدیریت گوگل است، بنابراین در نتیجه هزینهای از شما دریافت نخواهد شد.
من چندین توکن توسعهدهنده برای ابزارهای مختلف دارم. این طرح آزمایشی چه تاثیری بر من دارد؟
این مورد استفاده پشتیبانی نمیشود، بنابراین شما نمیتوانید در این طرح آزمایشی شرکت کنید.
آیا این موضوع بر مجوزهای API موجود برای حسابهایی که با استفاده از API تبلیغات گوگل مدیریت میکنم، تأثیر میگذارد؟
خیر، این تغییر هیچ تاثیری بر مجوزهای API موجود برای حسابهای گوگل ادز که با استفاده از API گوگل ادز مدیریت میکنید، ندارد.
من در این طرح آزمایشی شرکت کردم و مشکلی یا بازخوردی دارم. چگونه با پشتیبانی تماس بگیرم؟
با استفاده از صفحه پشتیبانی فنی API با تیم API گوگل ادز تماس بگیرید و ماهیت مشکل خود را توضیح دهید. در صورت امکان، جزئیاتی مانند شناسه سازمان و گزارشهای درخواست و پاسخ خود را نیز ذکر کنید.