إصلاح الخطأ 400: عدم التطابق في redirect_uri عند استيراد المراجعات من Google Business إلى Python

التغلب على مشكلات OAuth 2.0 لإعادة توجيه URI في تكامل واجهة برمجة تطبيقات مراجعات Google

عند دمج Google Business Review في لغة Python، يواجه العديد من المطورين الخطأ الشائع "الخطأ 400: redirect_uri_mismatch". تنشأ هذه المشكلة بسبب عدم التوافق بين عنوان URI لإعادة التوجيه في إعدادات OAuth 2.0 وما تم تحديده في Google Cloud Console. يمكن أن يؤدي الخطأ إلى منع الوصول إلى Google Reviews API، وهو أمر بالغ الأهمية لاسترداد تعليقات العملاء برمجيًا.

تعد سياسة OAuth 2.0 من Google صارمة، وتتطلب تطابقًا دقيقًا بين معرف URI لإعادة التوجيه الذي تم تكوينه والمستخدم أثناء المصادقة. يمكن أن يؤدي الفشل في تكوين هذا بشكل صحيح إلى الإحباط، خاصة عندما يتغير رقم منفذ إعادة التوجيه بشكل متكرر، كما أفاد العديد من المطورين. يعد فهم هذه المشكلة أمرًا ضروريًا لضمان اتصال سلس بواجهة برمجة التطبيقات (API) وتجنب الوصول إلى هذا الحاجز.

في هذه المقالة، سنستعرض خطوات حل الخطأ redirect_uri_mismatch عند الوصول إلى Google Business Review. من خلال تكوين بيانات اعتماد OAuth الخاصة بك بعناية، سنتخلص من هذه المشكلة ونمكنك من جلب المراجعات بسهولة. يتضمن الحل تعيين URI لإعادة التوجيه بشكل صحيح ومواءمته مع بيئة المضيف المحلي المستخدمة للتطوير.

سواء كنت تجلب المراجعات لتحليل أداء الأعمال أو لعرضها على موقع الويب الخاص بك، فإن فهم كيفية حل هذا الخطأ سيوفر الوقت ويضمن تفاعل واجهة برمجة التطبيقات (API) بنجاح. اتبع هذه الخطوات لإصلاح عدم التطابق والوصول إلى مراجعات Google Business الخاصة بك دون انقطاع.

يأمر	مثال للاستخدام
flow.run_local_server(port=8080)	يبدأ خادم ويب محلي على المنفذ المحدد للتعامل مع ترخيص OAuth 2.0. هذه الطريقة مخصصة لإدارة تدفق OAuth محليًا، خاصة لواجهات برمجة تطبيقات Google.
response.raise_for_status()	يُثير خطأ HTTPError إذا كانت استجابة واجهة برمجة التطبيقات (API) تحتوي على رمز حالة HTTP غير صالح. ويساعد ذلك في اكتشاف مشكلات مثل عناوين URL غير الصحيحة أو أخطاء الأذونات، مما يجعله ضروريًا للتعامل مع أخطاء طلب واجهة برمجة التطبيقات.
session.headers.update()	يقوم بتحديث رؤوس كائن الجلسة باستخدام رمز التفويض ونوع المحتوى اللازمين. يعد هذا أمرًا بالغ الأهمية لمصادقة طلبات واجهة برمجة التطبيقات (API) باستخدام Google Business API باستخدام بيانات اعتماد OAuth 2.0.
flow.fetch_token(authorization_response=request.url)	جلب رمز OAuth المميز بعد إعادة توجيه المستخدم مرة أخرى إلى التطبيق. تعالج هذه الطريقة استجابة التفويض، وهي ضرورية لإكمال تدفق OAuth 2.0 في Flask أو البيئات المحلية.
redirect_uri=url_for("oauth2callback", _external=True)	يُنشئ عنوان URI لإعادة التوجيه ديناميكيًا لتدفق OAuth، مع الإشارة إلى عنوان URL لرد الاتصال. تضمن هذه الطريقة في Flask استخدام إعادة التوجيه المناسبة أثناء عملية مصادقة OAuth.
loguru.logger	مكتبة تسجيل خفيفة الوزن تستخدم لتصحيح الأخطاء في الوقت الفعلي. فهو يوفر مخرجات سجل سهلة القراءة، وهو أمر مفيد بشكل خاص لتتبع التقدم المحرز في مصادقة OAuth وطلبات API.
Flow.from_client_secrets_file()	تهيئة تدفق OAuth 2.0 باستخدام بيانات الاعتماد المخزنة في ملف JSON. هذا الأمر مخصص للتعامل مع مصادقة OAuth باستخدام Google APIs ويستخدم لتحميل أسرار العميل في تطبيقات Python.
authorization_url, _ = flow.authorization_url()	يُنشئ عنوان URL للتفويض المطلوب لإعادة توجيه المستخدم لمصادقة OAuth. يعد هذا الأمر ضروريًا لبدء عملية ترخيص OAuth 2.0 في Google APIs.

فهم عملية OAuth 2.0 للوصول إلى Google Reviews API

تم تصميم نصوص Python الواردة أعلاه لجلب Google Business Review باستخدام Google My Business API. تتضمن الخطوة الأولى إعداد ترخيص OAuth 2.0، وهو مطلوب للتفاعل مع واجهات برمجة تطبيقات Google بشكل آمن. تبدأ هذه العملية بتحديد أسرار عميل OAuth في ملف JSON، الذي يحتوي على بيانات الاعتماد لمشروع Google Cloud الخاص بك. تعد بيانات الاعتماد هذه ضرورية لإنشاء وصول آمن و يجب أن يتطابق مع ما تم تكوينه في Google Cloud Console. يمكن أن يؤدي عدم التطابق إلى حدوث خطأ مثل "الخطأ 400: redirect_uri_mismatch."

بمجرد تحميل بيانات الاعتماد، يبدأ البرنامج النصي تدفق OAuth باستخدام InstalledAppFlow. يقوم هذا التدفق بتشغيل خادم محلي (في هذه الحالة، على المنفذ 8080) للتعامل مع ترخيص المستخدم. عندما يمنح المستخدم الإذن، يتلقى البرنامج النصي رمز وصول، وهو أمر ضروري لتقديم الطلبات المصرح بها إلى Google Reviews API. تتم هذه العملية تلقائيًا ويتم التعامل معها من خلال طريقةflow.run_local_server، مما يضمن تخزين بيانات الاعتماد واستخدامها بشكل آمن لطلبات واجهة برمجة التطبيقات. آليات التسجيل مثل يتم استخدامها لتتبع التدفق والتأكد من تسجيل أي مشكلات تمت مواجهتها بوضوح لتصحيح الأخطاء.

بعد الحصول على بيانات الاعتماد بنجاح، يقوم البرنامج النصي بإنشاء جلسة باستخدام مكتبة الطلبات. تتضمن هذه الجلسة رمز الوصول في رؤوسها، وهو مطلوب للمصادقة عند إجراء استدعاءات API إلى Google. يقوم البرنامج النصي بإنشاء عنوان URL الصحيح لنقطة نهاية API باستخدام معرف حساب عملك ومعرف الموقع. من خلال إرسال طلب GET إلى عنوان URL، يحاول البرنامج النصي جلب مراجعات لموقع العمل المحدد. ويتضمن أيضًا معالجة الأخطاء لاكتشاف أخطاء HTTP، مثل بيانات الاعتماد أو الأذونات غير الصحيحة، مما يضمن إدارة أي مشكلات تتم مواجهتها أثناء الطلب بكفاءة.

يتم تحليل الاستجابة الواردة من Google Reviews API ككائن JSON، والذي يحتوي على المراجعات الخاصة بموقع النشاط التجاري. إذا نجح الطلب، فستتم طباعة المراجعات على وحدة التحكم، ويقوم البرنامج النصي بتسجيل رسالة نجاح. يضمن هذا النهج المعياري إمكانية تكرار العملية بسهولة وتخصيصها لمواقع أو حسابات مختلفة. علاوة على ذلك، من خلال الحفاظ على بنية واضحة لإدارة الجلسة ومعالجة الأخطاء، يعمل البرنامج النصي على تحسين الأمان والأداء عند العمل مع Google Reviews API. يتيح ذلك للمطورين الوصول بكفاءة إلى مراجعات العملاء وإدارتها للتحليل أو العرض.

import requests
from google_auth_oauthlib.flow import InstalledAppFlow
from loguru import logger as log
# Replace with your actual Google Business account and location IDs
my_business_account_id = "YOUR_ACCOUNT_ID"
location_id = "YOUR_LOCATION_ID"
# Path to your OAuth 2.0 Client Secret JSON file
GCP_CREDENTIALS_PATH = "path/to/your/google_review_client.json"
# Set a consistent redirect URI
redirect_uri = "http://localhost:8080/"
# Setup the OAuth 2.0 flow with required scopes
flow = InstalledAppFlow.from_client_secrets_file(
    GCP_CREDENTIALS_PATH,
    scopes=["https://www.googleapis.com/auth/business.manage"],
    redirect_uri=redirect_uri)
# Run OAuth flow to obtain credentials
credentials = flow.run_local_server(port=8080)
log.debug(f"Credentials: {credentials}")
# Setup the API request session
session = requests.Session()
session.headers.update({"Authorization": f"Bearer {credentials.token}"})
# Construct the API endpoint URL
url = f"https://mybusiness.googleapis.com/v4/accounts/{my_business_account_id}/locations/{location_id}/reviews"
# Make API request and handle potential errors
try:
    response = session.get(url)
    response.raise_for_status()
    reviews = response.json()
    print("Reviews fetched successfully.")
    print(reviews)
except requests.exceptions.HTTPError as http_err:
    log.error(f"HTTP error: {http_err}")
except Exception as err:
    log.error(f"Unexpected error: {err}")

# Step 1: Open Google Cloud Console
# Step 2: Navigate to your project and go to "APIs & Services" > "Credentials"
# Step 3: Edit the OAuth 2.0 Client IDs settings
# Step 4: In "Authorized redirect URIs", add "http://localhost:8080/"
# Step 5: Save your changes
# After setting the correct redirect URI, re-run your Python script
# This ensures the OAuth 2.0 flow will use the correct URI during authentication

from flask import Flask, redirect, request, session, url_for
from google_auth_oauthlib.flow import Flow
# Flask setup
app = Flask(__name__)
app.secret_key = "your_secret_key"
# Path to OAuth 2.0 Client Secret JSON
GCP_CREDENTIALS_PATH = "google_review_client.json"
@app.route("/authorize")
def authorize():
    flow = Flow.from_client_secrets_file(
        GCP_CREDENTIALS_PATH,
        scopes=["https://www.googleapis.com/auth/business.manage"],
        redirect_uri=url_for("oauth2callback", _external=True)
    )
    authorization_url, _ = flow.authorization_url()
    return redirect(authorization_url)
@app.route("/oauth2callback")
def oauth2callback():
    flow = Flow.from_client_secrets_file(
        GCP_CREDENTIALS_PATH,
        scopes=["https://www.googleapis.com/auth/business.manage"],
        redirect_uri=url_for("oauth2callback", _external=True)
    )
    flow.fetch_token(authorization_response=request.url)
    session["credentials"] = flow.credentials
    return redirect("/reviews")
# Run the Flask server
if __name__ == "__main__":
    app.run("localhost", 8080)

حل مشكلات إعادة توجيه OAuth في Google APIs لتكامل Python

أحد الجوانب المهمة التي غالبًا ما يتم تجاهلها عند دمج Google APIs في تطبيقات Python هو التكوين الدقيق لـ . يعد هذا الإعداد أمرًا حيويًا لمصادقة OAuth 2.0، وغالبًا ما يؤدي عدم التطابق في معرف URI هذا إلى ظهور الخطأ "الخطأ 400: redirect_uri_mismatch". تعتبر عملية مصادقة Google صارمة لضمان أن التدفق آمن ويتبع أفضل الممارسات. لذلك، يحتاج المطورون إلى التأكد من أن عنوان URI لإعادة التوجيه الذي تم تكوينه في Google Cloud Console يتطابق تمامًا مع ذلك المستخدم في رمز التطبيق الخاص بهم.

جانب آخر مهم هو فهم كيفية عمل المنافذ في تدفق OAuth، خاصة عند العمل في بيئة محلية. يواجه المطورون بشكل متكرر أرقام المنافذ المتغيرة (مثل الخطأ "52271" المذكور سابقًا) عند استخدام أدوات مثل . يُنصح بإصلاح رقم المنفذ (على سبيل المثال، ) لتجنب عدم التطابق، ويمكن القيام بذلك عن طريق تمرير رقم المنفذ بشكل صريح في الكود. وهذا لا يضمن الاتساق فحسب، بل يمنع أيضًا الأخطاء التي تنشأ بسبب تعيين المنفذ الديناميكي.

بالإضافة إلى ذلك، إدارة الخاص بك بشكل آمن أمر ضروري. يجب تخزين ملف JSON الذي يحتوي على أسرار العميل في مكان آمن، ويجب تحديث رموز الوصول بشكل دوري. يضمن الحفاظ على تحديث هذه الرموز المميزة بقاء استدعاءات واجهة برمجة التطبيقات (API) صالحة، حيث يمكن أن تتسبب الرموز المميزة منتهية الصلاحية أيضًا في حدوث مشكلات في المصادقة. بشكل عام، تضمن الإدارة الدقيقة لتدفق المصادقة تكاملًا أكثر سلاسة وتزيل المخاطر الشائعة مثل خطأ عدم تطابق URI الخاص بإعادة التوجيه.

1. ما الذي يسبب "الخطأ 400: redirect_uri_mismatch" في واجهات برمجة تطبيقات Google؟
2. يحدث هذا الخطأ بسبب عدم التطابق بين عنوان URI لإعادة التوجيه في الكود الخاص بك والمسجل في Google Cloud Console. تأكد من أنها تطابق تماما.
3. كيف يمكنني إصلاح رقم المنفذ عند الاستخدام ؟
4. لإصلاح رقم المنفذ، حدد منفذًا ثابتًا مثل 8080 عن طريق المرور في طريقة.
5. ماذا علي أن أفعل إذا كان بلدي تنتهي؟
6. يجب عليك تنفيذ منطق تحديث الرمز المميز باستخدام مكتبة OAuth من Google لطلب رمز مميز جديد قبل انتهاء صلاحية الرمز الحالي.
7. هل يمكنني استخدام API دون تسجيل حساب الخدمة؟
8. لا، يجب عليك إنشاء حساب خدمة وتنزيل ملف مفتاح JSON لمصادقة تطبيقك للوصول إلى Google Reviews API.
9. لماذا الاستمرار في التغيير أثناء الاختبار؟
10. يحدث هذا عادةً عند استخدام تعيينات المنفذ الديناميكي. لحل هذه المشكلة، قم بتعيين منفذ ثابت (على سبيل المثال، 8080) في إعداد خادم OAuth المحلي.

لحل الخطأ "الخطأ 400: redirect_uri_mismatch"، من الضروري تكوين بيانات اعتماد OAuth 2.0 بشكل صحيح والتأكد من تطابق معرف URI لإعادة التوجيه في الرمز مع ذلك المسجل في Google Cloud. تعتبر هذه الخطوة ضرورية لتكامل واجهة برمجة التطبيقات (API) بنجاح.

بالإضافة إلى ذلك، فإن إدارة رؤوس الجلسة والتعامل مع أخطاء HTTP المحتملة بشكل صحيح يضمن الوصول السلس إلى Google Reviews API. من خلال إصلاح المنفذ وتحسين التعليمات البرمجية الخاصة بك، يمكن للمطورين استرداد المراجعات بكفاءة، مما يسمح للشركات بمراقبة تعليقات العملاء بسهولة.