> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gorbit.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# موصل Bitbucket

> الوصول إلى المعرفة من مستودعات Bitbucket الخاصة بك (السحابة فقط)

## كيف يعمل

يقوم موصل Bitbucket بفهرسة جميع طلبات السحب من مستودع Bitbucket Cloud محدد، أو مشروع،
أو مساحة عمل كاملة.

* يقوم بفهرسة طلبات السحب `OPEN` و `MERGED` و `DECLINED`، بما في ذلك عناوينها وأوصافها.
* كما يلتقط البيانات الوصفية الرئيسية مثل المؤلف والمراجعين والحالة الحالية وطوابع الوقت للإنشاء/التحديث،
  ورابط مباشر يعود إلى طلب السحب الأصلي في Bitbucket.

## الإعداد

<Note>
  يمكن استخدام هذا الموصل فقط مع Bitbucket Cloud.
</Note>

### التفويض

يستخدم موصل Bitbucket رمز API للمصادقة.

لإنشاء رمز API:

<Steps>
  <Step title="تسجيل الدخول إلى Bitbucket">
    سجل الدخول إلى حساب Bitbucket الخاص بك.
  </Step>

  <Step title="فتح إعدادات الحساب">
    حدد **ترس الإعدادات** في الزاوية العلوية اليمنى من شريط التنقل العلوي.
  </Step>

  <Step title="الوصول إلى إعدادات حساب Atlassian">
    تحت **Personal settings**، حدد **Atlassian account settings**.
  </Step>

  <Step title="الانتقال إلى علامة التبويب Security">
    حدد علامة تبويب **Security** في شريط التنقل العلوي.
  </Step>

  <Step title="إدارة رموز API">
    حدد **Create and manage API tokens**.
  </Step>

  <Step title="إنشاء رمز محدد النطاق">
    حدد **Create API token with scopes**.
  </Step>

  <Step title="تسمية الرمز">
    أعطِ رمز API اسمًا وتاريخ انتهاء صلاحية،
    عادة ما يكون مرتبطًا بالتطبيق الذي سيستخدم الرمز وحدد **Next**.
  </Step>

  <Step title="اختيار Bitbucket">
    حدد **Bitbucket** كتطبيق وحدد **Next**.
  </Step>

  <Step title="تحديد النطاقات">
    حدد النطاقات (الأذونات) التي يحتاجها رمز API وحدد **Next**.

    * **Projects**: `read:project:bitbucket`
    * **Repositories**: `read:repository:bitbucket`
    * **Pull Requests**: `read:pullrequest:bitbucket`
  </Step>

  <Step title="إنشاء الرمز">
    راجع رمزك وحدد زر *Create token*. ستعرض الصفحة رمز API الجديد.
  </Step>

  <Step title="حفظ الرمز">
    انسخ رمز API المُنشأ وسجله أو الصقه في التطبيق الذي تريد منحه الوصول.
  </Step>
</Steps>

<Note>
  يُعرض الرمز مرة واحدة فقط ولا يمكن استرداده لاحقًا.
</Note>

للحصول على أحدث التعليمات،
راجع [وثائق Bitbucket الرسمية](https://support.atlassian.com/bitbucket-cloud/docs/create-an-api-token/).

### الفهرسة

<Steps>
  <Step title="افتح موصل Bitbucket">
    انتقل إلى لوحة الإدارة وحدد موصل **Bitbucket**.
  </Step>

  <Step title="إنشاء بيانات الاعتماد">
    انقر على **Create new credentials** وقدم ما يلي:

    * **Name**: اسم وصفي لبيانات اعتمادك.
    * **Email**: عنوان البريد الإلكتروني لحساب Bitbucket الخاص بك.
    * **API token**: رمز API الذي أنشأته في الخطوة السابقة.

          <img src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/bitbucket/BitbucketConnectorCred.png?fit=max&auto=format&n=i9pIrvFbh53KkrjR&q=85&s=5eeffd8fc3fcc5af73fb1092c6532692" alt="BitbucketConnector" width="1824" height="1092" data-path="assets/admins/connectors/bitbucket/BitbucketConnectorCred.png" />
  </Step>

  <Step title="تكوين تفاصيل الموصل">
    املأ تفاصيل الموصل:

    * **Name**: اسم وصفي للموصل.
    * **Workspace name**: `WORKSPACE_NAME` من عنوان URL لـ Bitbucket الخاص بك (`https://bitbucket.org/{WORKSPACE_NAME}/...`).
    * **Repositories or Projects (اختياري)**: قائمة مفصولة بفواصل من مقاطع المستودعات أو مفاتيح المشاريع لفهرستها.

          <img src="https://mintcdn.com/gorbit/i9pIrvFbh53KkrjR/assets/admins/connectors/bitbucket/BitbucketConnector.png?fit=max&auto=format&n=i9pIrvFbh53KkrjR&q=85&s=02705b135e27f171549deaf4d0c48891" alt="BitbucketConnector" width="3336" height="1566" data-path="assets/admins/connectors/bitbucket/BitbucketConnector.png" />
  </Step>
</Steps>

سيقوم هذا التكوين بفهرسة جميع طلبات السحب من المستودعات المحددة.
يمكنك أيضًا تكوينه لفهرسة جميع المستودعات داخل مشروع أو مساحة عمل كاملة.