خطاهای رایج

این صفحه خطاهای رایج را فهرست کرده و نکاتی در مورد پیشگیری و مدیریت آنها ارائه می‌دهد. برای مشاهده لیست کامل خطاها، منابع خطا را بررسی کنید. برای پشتیبانی بیشتر، از انجمن ما دیدن کنید.

google.rpc.ErrorInfo

ACCESS_TOKEN_SCOPE_INSUFFICIENT
خلاصه توکن دسترسی OAuth 2.0 دامنه‌های مورد نیاز را ندارد.
علل شایع درخواست رد می‌شود زیرا توکن دسترسی ارائه شده شامل محدوده‌ی OAuth 2.0 مربوط به API تبلیغات گوگل نمی‌شود.
نحوه رسیدگی مطمئن شوید که توکن دسترسی، محدوده‌های مورد نیاز را دارد. یکی از دلایل رایج این خطا این است که شما در حال استفاده مجدد از یک توکن دسترسی موجود هستید که با استفاده از مجموعه‌ای متفاوت از محدوده‌های OAuth تولید شده است. برای مثالی از نحوه تولید یک توکن دسترسی جدید با محدوده‌های مورد نیاز، به پارامترهای مجوز OAuth مراجعه کنید.
نکات پیشگیری مطمئن شوید که توکن دسترسی، محدوده‌های مورد نیاز را دارد. برای دسترسی به محدوده‌های مورد نیاز، کاربر خود را با محدوده‌های مورد نیاز مجدداً احراز هویت کنید. اگر برنامه شما از چندین محدوده OAuth استفاده می‌کند، ممکن است نیاز به پیاده‌سازی مجوزهای Granular OAuth داشته باشید.

google.auth.exceptions.RefreshError

invalid_grant
خلاصه توکن منقضی یا باطل شده است.
علل شایع به یک پروژه پلتفرم ابری گوگل که صفحه رضایت OAuth آن برای نوع کاربر خارجی پیکربندی شده و وضعیت انتشار آن در Testing است، یک توکن به‌روزرسانی صادر می‌شود که ظرف ۷ روز منقضی می‌شود.
نحوه رسیدگی وضعیت انتشار پروژه گوگل شما در Testing است، بنابراین توکن به‌روزرسانی هر ۷ روز یکبار منقضی می‌شود و خطای invalid_grant دریافت می‌کند. به کنسول API گوگل بروید و به صفحه رضایت OAuth بروید. سپس با دنبال کردن این دستورالعمل‌ها، وضعیت انتشار را به In production تغییر دهید تا از منقضی شدن توکن به‌روزرسانی ظرف ۷ روز جلوگیری شود.
نکات پیشگیری برنامه‌های تأیید نشده را ببینید.

AuthenticationError

CLIENT_CUSTOMER_ID_INVALID
خلاصه شناسه مشتری کلاینت یک عدد نیست.
علل شایع استفاده از شناسه مشتری نامناسب.
نحوه رسیدگی ناموجود
نکات پیشگیری ۱۲۳-۴۵۶-۷۸۹۰ باید ۱۲۳۴۵۶۷۸۹۰ باشد. برای جزئیات بیشتر به «شروع به کار» مراجعه کنید.
CLIENT_CUSTOMER_ID_IS_REQUIRED
خلاصه شناسه مشتری کلاینت در هدر HTTP مشخص نشده است.
علل شایع عدم مشخص کردن شناسه مشتری کلاینت در هدر HTTP.
نحوه رسیدگی ناموجود
نکات پیشگیری شناسه مشتری کلاینت برای همه فراخوانی‌ها لازم است، بنابراین مطمئن شوید که آن را در هدر HTTP مشخص کرده‌اید. استفاده از کتابخانه‌های کلاینت ما را در نظر بگیرید زیرا آنها این کار را برای شما انجام می‌دهند.
CUSTOMER_NOT_FOUND
خلاصه هیچ حسابی برای شناسه مشتری ارائه شده در سربرگ یافت نشد.
علل شایع تلاش برای دسترسی به حسابی که قبل از ایجاد حساب در backend ایجاد شده است.
نحوه رسیدگی پنج دقیقه اول صبر کنید، سپس هر 30 ثانیه دوباره امتحان کنید.
نکات پیشگیری قبل از ارسال درخواست علیه حساب، چند دقیقه پس از ایجاد حساب صبر کنید.
خلاصه توکن دسترسی موجود در هدر درخواست یا نامعتبر است یا منقضی شده است.
علل شایع توکن دسترسی نامعتبر شده است.
نحوه رسیدگی درخواست یک توکن جدید. اگر از یکی از کتابخانه‌های کلاینت ما استفاده می‌کنید، برای نحوه به‌روزرسانی توکن، به مستندات آن مراجعه کنید.
نکات پیشگیری توکن‌های دسترسی را تا زمان انقضا ذخیره و دوباره استفاده کنید.
NOT_ADS_USER
خلاصه حساب گوگلی که برای تولید توکن دسترسی استفاده می‌شود، به هیچ حساب گوگل ادز مرتبط نیست.
علل شایع اطلاعات ورود ارائه شده مربوط به یک حساب گوگل است که تبلیغات گوگل در آن فعال نیست.
نحوه رسیدگی مطمئن شوید که برای جریان OAuth با یک حساب کاربری معتبر گوگل ادز (معمولاً حساب کاربری مدیر شما) وارد سیستم می‌شوید. همچنین می‌توانید با ورود به حساب کاربری مدیر خود، انتخاب حساب کاربری مشتری یا مدیر مورد نظر، رفتن به Tools and Settings > Access and security و سپس اضافه کردن آدرس ایمیل حساب کاربری گوگل، حساب کاربری گوگل را برای دسترسی به یک حساب کاربری گوگل ادز موجود دعوت کنید.
نکات پیشگیری ناموجود
OAUTH_TOKEN_INVALID
خلاصه توکن دسترسی OAuth در هدر معتبر نیست.
علل شایع توکن دسترسی شما که با هدر HTTP ارسال شده بود، صحیح نبود.
نحوه رسیدگی ناموجود
نکات پیشگیری مطمئن شوید که توکن دسترسی صحیح مرتبط با حساب کاربری خود را وارد کرده‌اید. گاهی اوقات با توکن‌های تازه‌سازی و کدهای مجوز اشتباه گرفته می‌شود. اگر می‌خواهید اعتبارنامه‌ای دریافت کنید که بتواند به همه حساب‌های کاربری تحت یک حساب کاربری مدیر دسترسی داشته باشد، مطمئن شوید که توکن تازه‌سازی را برای حساب کاربری مدیر دریافت کرده‌اید. به راهنمای احراز هویت کاربر مراجعه کنید.
ORGANIZATION_NOT_ASSOCIATED_WITH_DEVELOPER_TOKEN
خلاصه توکن توسعه‌دهنده از قبل با یک سازمان Google Cloud مرتبط است و نمی‌تواند با سازمان دیگری مرتبط شود.
علل شایع توکن توسعه‌دهنده با یک پروژه Google Cloud در همان سازمان Google Cloud که پروژه Google Cloud در ابتدا برای ارسال درخواست‌ها استفاده می‌کرد، مرتبط نیست.
نحوه رسیدگی اگر قبلاً درخواست‌های API را با توکن توسعه‌دهنده ارسال کرده‌اید، مطمئن شوید که شناسه کلاینت OAuth با پروژه‌های Google Cloud در همان سازمان Google Cloud مرتبط باشد.
نکات پیشگیری مطمئن شوید که تمام پروژه‌های گوگل کلود شما با یک سازمان گوگل کلود مرتبط هستند. یک پروژه گوگل کلود می‌تواند فقط با یک توکن توسعه‌دهنده مرتبط باشد، اما یک توکن توسعه‌دهنده می‌تواند با چندین پروژه در آن سازمان مرتبط باشد.
DEVELOPER_TOKEN_INVALID
خلاصه توکن توسعه‌دهنده نامعتبر است.
علل شایع دلایل رایج این خطا شامل غلط املایی در توکن توسعه‌دهنده یا تنظیم نادرست توکن توسعه‌دهنده در یک هدر درخواست متفاوت است.
نحوه رسیدگی مطمئن شوید که توکن توسعه‌دهنده را از مرکز API کپی می‌کنید تا از اشتباهات تایپی جلوگیری شود. می‌توانید مرکز API را در حساب مدیریت تبلیغات گوگل خود پیدا کنید . همچنین، مطمئن شوید که توکن توسعه‌دهنده را در هدر صحیح تنظیم می‌کنید. توکن‌های توسعه‌دهنده گاهی اوقات با توکن‌های به‌روزرسانی OAuth و کدهای مجوز اشتباه گرفته می‌شوند. اطلاعات بیشتر در مورد هدرهای درخواست مختلف را اینجا بخوانید.
نکات پیشگیری ناموجود

AuthorizationError

CUSTOMER_NOT_ENABLED
خلاصه دسترسی به حساب مشتری امکان‌پذیر نیست زیرا در حالت فعال نیست.
علل شایع این اتفاق زمانی رخ می‌دهد که حساب مشتری ثبت نام را تکمیل نکرده یا غیرفعال شده باشد.
نحوه رسیدگی وارد رابط کاربری گوگل ادز شوید و مطمئن شوید که مراحل ثبت نام برای این حساب را تکمیل کرده‌اید. برای حساب‌های غیرفعال شده، به بخش فعال‌سازی مجدد حساب لغو شده گوگل ادز مراجعه کنید.
نکات پیشگیری شما می‌توانید با بررسی وضعیت «لغو شده» ، غیرفعال شدن حساب مشتری را بررسی کنید.
DEVELOPER_TOKEN_NOT_APPROVED
خلاصه توکن توسعه‌دهنده فقط برای استفاده با حساب‌های آزمایشی و تلاش برای دسترسی به یک حساب غیر آزمایشی تأیید شده است.
علل شایع یک توکن توسعه‌دهنده آزمایشی برای دسترسی به یک حساب کاربری غیر آزمایشی استفاده شده است.
نحوه رسیدگی مطمئن شوید که واقعاً می‌خواهید به یک حساب کاربری غیر آزمایشی دسترسی داشته باشید. در این صورت، باید برای ارتقاء توکن توسعه‌دهنده خود به دسترسی استاندارد یا پایه درخواست دهید .
نکات پیشگیری ناموجود
DEVELOPER_TOKEN_PROHIBITED
خلاصه استفاده از توکن توسعه‌دهنده در پروژه ارسالی در درخواست مجاز نیست.
علل شایع هر پروژه کنسول API گوگل می‌تواند فقط از یک حساب کاربری مدیر به توکن توسعه‌دهنده مرتبط شود. پس از ارسال درخواست API گوگل ادز، توکن توسعه‌دهنده به طور دائم به پروژه کنسول API گوگل متصل می‌شود. اگر از یک پروژه جدید کنسول API گوگل استفاده نکنید، هنگام ارسال درخواست با خطای DEVELOPER_TOKEN_PROHIBITED مواجه خواهید شد.
نحوه رسیدگی ناموجود
نکات پیشگیری اگر می‌خواهید با یک حساب کاربری مدیر جدید به یک توکن توسعه‌دهنده تغییر دهید، باید یک پروژه جدید کنسول API گوگل برای درخواست‌های API تبلیغات گوگل که از توکن مدیر جدید استفاده می‌کنند، ایجاد کنید .
USER_PERMISSION_DENIED
خلاصه مشتری مجاز به مشتری در حال کار دسترسی ندارد.
علل شایع احراز هویت به عنوان یک کاربر با دسترسی به حساب کاربری مدیریت، اما عدم مشخص کردن login-customer-id در درخواست.
نحوه رسیدگی ناموجود
نکات پیشگیری login-customer-id به عنوان شناسه حساب مدیر بدون خط تیره ( - ) مشخص کنید. کتابخانه‌های کلاینت از این قابلیت پشتیبانی می‌کنند.

قبلی
شروع سریع
بعدی
مراحل بعدی