نظرة عامة
مكّن وكلاءك من إدارة جهات الاتصال ومعلومات الدليل عبر Google Contacts. يمكنك الوصول إلى جهات الاتصال الشخصية، والبحث في أشخاص الدليل، وإنشاء معلومات الاتصال وتحديثها، وإدارة مجموعات جهات الاتصال باستخدام الأتمتة المدعومة بالذكاء الاصطناعي.المتطلبات الأساسية
قبل استخدام تكامل Google Contacts، تأكد من توفر ما يلي:- حساب CrewAI AMP مع اشتراك فعّال
- حساب Google مع إمكانية الوصول إلى Google Contacts
- ربط حساب Google الخاص بك عبر صفحة التكاملات
إعداد تكامل Google Contacts
1. ربط حساب Google الخاص بك
- انتقل إلى تكاملات CrewAI AMP
- ابحث عن Google Contacts في قسم تكاملات المصادقة
- انقر على Connect وأكمل عملية OAuth
- امنح الصلاحيات اللازمة للوصول إلى جهات الاتصال والدليل
- انسخ رمز المؤسسة من إعدادات التكامل
2. تثبيت الحزمة المطلوبة
3. إعداد متغير البيئة
لاستخدام التكاملات مع
Agent(apps=[]), يجب تعيين متغير البيئة
CREWAI_PLATFORM_INTEGRATION_TOKEN برمز المؤسسة الخاص بك..env:
الإجراءات المتاحة
google_contacts/get_contacts
google_contacts/get_contacts
الوصف: استرجاع جهات اتصال المستخدم من Google Contacts.المعاملات:
pageSize(integer, اختياري): عدد جهات الاتصال المراد إرجاعها (الحد الأقصى 1000). الحد الأدنى: 1، الحد الأقصى: 1000pageToken(string, اختياري): رمز الصفحة المراد استرجاعها.personFields(string, اختياري): الحقول المراد تضمينها (مثال: ‘names,emailAddresses,phoneNumbers’). الافتراضي: names,emailAddresses,phoneNumbersrequestSyncToken(boolean, اختياري): ما إذا كان يجب أن تتضمن الاستجابة رمز مزامنة. الافتراضي: falsesortOrder(string, اختياري): ترتيب الفرز للاتصالات. الخيارات: LAST_MODIFIED_ASCENDING, LAST_MODIFIED_DESCENDING, FIRST_NAME_ASCENDING, LAST_NAME_ASCENDING
google_contacts/search_contacts
google_contacts/search_contacts
الوصف: البحث عن جهات اتصال باستخدام سلسلة استعلام.المعاملات:
query(string, مطلوب): سلسلة استعلام البحثreadMask(string, مطلوب): الحقول المراد قراءتها (مثال: ‘names,emailAddresses,phoneNumbers’)pageSize(integer, اختياري): عدد النتائج المراد إرجاعها. الحد الأدنى: 1، الحد الأقصى: 30pageToken(string, اختياري): رمز يحدد صفحة النتائج المراد إرجاعها.sources(array, اختياري): المصادر المراد البحث فيها. الخيارات: READ_SOURCE_TYPE_CONTACT, READ_SOURCE_TYPE_PROFILE. الافتراضي: READ_SOURCE_TYPE_CONTACT
google_contacts/list_directory_people
google_contacts/list_directory_people
الوصف: عرض قائمة الأشخاص في دليل المستخدم المصادق عليه.المعاملات:
sources(array, مطلوب): مصادر الدليل المراد البحث فيها. الخيارات: DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE, DIRECTORY_SOURCE_TYPE_DOMAIN_CONTACT. الافتراضي: DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILEpageSize(integer, اختياري): عدد الأشخاص المراد إرجاعهم. الحد الأدنى: 1، الحد الأقصى: 1000pageToken(string, اختياري): رمز يحدد صفحة النتائج المراد إرجاعها.readMask(string, اختياري): الحقول المراد قراءتها (مثال: ‘names,emailAddresses’)requestSyncToken(boolean, اختياري): ما إذا كان يجب أن تتضمن الاستجابة رمز مزامنة. الافتراضي: falsemergeSources(array, اختياري): بيانات إضافية لدمجها في استجابات أشخاص الدليل. الخيارات: CONTACT
google_contacts/search_directory_people
google_contacts/search_directory_people
الوصف: البحث عن أشخاص في الدليل.المعاملات:
query(string, مطلوب): استعلام البحثsources(string, مطلوب): مصادر الدليل (استخدم ‘DIRECTORY_SOURCE_TYPE_DOMAIN_PROFILE’)pageSize(integer, اختياري): عدد النتائج المراد إرجاعهاreadMask(string, اختياري): الحقول المراد قراءتها
google_contacts/list_other_contacts
google_contacts/list_other_contacts
الوصف: عرض جهات الاتصال الأخرى (غير الموجودة في جهات الاتصال الشخصية).المعاملات:
pageSize(integer, اختياري): عدد جهات الاتصال المراد إرجاعها. الحد الأدنى: 1، الحد الأقصى: 1000pageToken(string, اختياري): رمز يحدد صفحة النتائج المراد إرجاعها.readMask(string, اختياري): الحقول المراد قراءتهاrequestSyncToken(boolean, اختياري): ما إذا كان يجب أن تتضمن الاستجابة رمز مزامنة. الافتراضي: false
google_contacts/search_other_contacts
google_contacts/search_other_contacts
الوصف: البحث في جهات الاتصال الأخرى.المعاملات:
query(string, مطلوب): استعلام البحثreadMask(string, مطلوب): الحقول المراد قراءتها (مثال: ‘names,emailAddresses’)pageSize(integer, اختياري): عدد النتائج
google_contacts/get_person
google_contacts/get_person
الوصف: الحصول على معلومات الاتصال لشخص واحد بواسطة اسم المورد.المعاملات:
resourceName(string, مطلوب): اسم المورد للشخص المراد الحصول عليه (مثال: ‘people/c123456789’)personFields(string, اختياري): الحقول المراد تضمينها (مثال: ‘names,emailAddresses,phoneNumbers’). الافتراضي: names,emailAddresses,phoneNumbers
google_contacts/create_contact
google_contacts/create_contact
الوصف: إنشاء جهة اتصال جديدة في دفتر عناوين المستخدم.المعاملات:
names(array, اختياري): أسماء الشخصemailAddresses(array, اختياري): عناوين البريد الإلكترونيphoneNumbers(array, اختياري): أرقام الهاتفaddresses(array, اختياري): العناوين البريديةorganizations(array, اختياري): المؤسسات/الشركات
google_contacts/update_contact
google_contacts/update_contact
الوصف: تحديث معلومات جهة اتصال موجودة.المعاملات:
resourceName(string, مطلوب): اسم المورد للشخص المراد تحديثه (مثال: ‘people/c123456789’)updatePersonFields(string, مطلوب): الحقول المراد تحديثها (مثال: ‘names,emailAddresses,phoneNumbers’)names(array, اختياري): أسماء الشخصemailAddresses(array, اختياري): عناوين البريد الإلكترونيphoneNumbers(array, اختياري): أرقام الهاتف
google_contacts/delete_contact
google_contacts/delete_contact
الوصف: حذف جهة اتصال من دفتر عناوين المستخدم.المعاملات:
resourceName(string, مطلوب): اسم المورد للشخص المراد حذفه (مثال: ‘people/c123456789’)
google_contacts/batch_get_people
google_contacts/batch_get_people
الوصف: الحصول على معلومات عن عدة أشخاص في طلب واحد.المعاملات:
resourceNames(array, مطلوب): أسماء موارد الأشخاص المراد الحصول عليهم. الحد الأقصى: 200 عنصرpersonFields(string, اختياري): الحقول المراد تضمينها (مثال: ‘names,emailAddresses,phoneNumbers’). الافتراضي: names,emailAddresses,phoneNumbers
google_contacts/list_contact_groups
google_contacts/list_contact_groups
الوصف: عرض مجموعات جهات اتصال المستخدم (التصنيفات).المعاملات:
pageSize(integer, اختياري): عدد مجموعات جهات الاتصال المراد إرجاعها. الحد الأدنى: 1، الحد الأقصى: 1000pageToken(string, اختياري): رمز يحدد صفحة النتائج المراد إرجاعها.groupFields(string, اختياري): الحقول المراد تضمينها (مثال: ‘name,memberCount,clientData’). الافتراضي: name,memberCount
google_contacts/get_contact_group
google_contacts/get_contact_group
الوصف: الحصول على مجموعة جهات اتصال محددة بواسطة اسم المورد.المعاملات:
resourceName(string, مطلوب): اسم المورد لمجموعة جهات الاتصال (مثال: ‘contactGroups/myContactGroup’)maxMembers(integer, اختياري): الحد الأقصى لعدد الأعضاء المراد تضمينهم. الحد الأدنى: 0، الحد الأقصى: 20000groupFields(string, اختياري): الحقول المراد تضمينها (مثال: ‘name,memberCount,clientData’). الافتراضي: name,memberCount
google_contacts/create_contact_group
google_contacts/create_contact_group
الوصف: إنشاء مجموعة جهات اتصال جديدة (تصنيف).المعاملات:
name(string, مطلوب): اسم مجموعة جهات الاتصالclientData(array, اختياري): بيانات خاصة بالعميل
google_contacts/update_contact_group
google_contacts/update_contact_group
الوصف: تحديث معلومات مجموعة جهات اتصال.المعاملات:
resourceName(string, مطلوب): اسم المورد لمجموعة جهات الاتصال (مثال: ‘contactGroups/myContactGroup’)name(string, مطلوب): اسم مجموعة جهات الاتصالclientData(array, اختياري): بيانات خاصة بالعميل
google_contacts/delete_contact_group
google_contacts/delete_contact_group
الوصف: حذف مجموعة جهات اتصال.المعاملات:
resourceName(string, مطلوب): اسم المورد لمجموعة جهات الاتصال المراد حذفها (مثال: ‘contactGroups/myContactGroup’)deleteContacts(boolean, اختياري): ما إذا كان يجب حذف جهات الاتصال في المجموعة أيضاً. الافتراضي: false
أمثلة الاستخدام
إعداد Agent أساسي لـ Google Contacts
البحث في الدليل وإدارته
إنشاء جهات الاتصال وتحديثاتها
إدارة مجموعات جهات الاتصال
إدارة جهات الاتصال الشاملة
استكشاف الأخطاء وإصلاحها
المشاكل الشائعة
أخطاء الصلاحيات- تأكد من أن حساب Google الخاص بك لديه الصلاحيات المناسبة للوصول إلى جهات الاتصال
- تحقق من أن اتصال OAuth يتضمن النطاقات المطلوبة لـ Google Contacts API
- تحقق من منح صلاحيات الوصول للدليل لجهات اتصال المؤسسة
- تأكد من أن أسماء الموارد تتبع الصيغة الصحيحة (مثال: ‘people/c123456789’ لجهات الاتصال)
- تحقق من أن أسماء موارد مجموعات جهات الاتصال تستخدم الصيغة ‘contactGroups/groupId’
- تأكد من وجود أسماء الموارد وإمكانية الوصول إليها
- تأكد من صحة صيغة استعلامات البحث وعدم كونها فارغة
- استخدم حقول readMask المناسبة للبيانات التي تحتاجها
- تحقق من صحة تحديد مصادر البحث (جهات اتصال مقابل ملفات تعريف)
- تأكد من توفير الحقول المطلوبة عند إنشاء جهات الاتصال
- تحقق من صحة صيغة عناوين البريد الإلكتروني وأرقام الهاتف
- تأكد من أن معامل updatePersonFields يتضمن جميع الحقول التي يتم تحديثها
- تأكد من أن لديك الصلاحيات المناسبة للوصول إلى دليل المؤسسة
- تحقق من صحة تحديد مصادر الدليل
- تأكد من أن مؤسستك تسمح بالوصول عبر API إلى معلومات الدليل
- انتبه لحدود حجم الصفحة (تختلف حسب نقطة النهاية)
- استخدم pageToken للترقيم عبر مجموعات النتائج الكبيرة
- احترم حدود معدل API وطبّق تأخيرات مناسبة
- تأكد من أن أسماء مجموعات جهات الاتصال فريدة عند إنشاء مجموعات جديدة
- تحقق من وجود جهات الاتصال قبل إضافتها إلى المجموعات
- تأكد من أن لديك صلاحيات تعديل مجموعات جهات الاتصال
الحصول على المساعدة
تحتاج مساعدة؟
تواصل مع فريق الدعم للحصول على المساعدة في إعداد تكامل Google Contacts
أو استكشاف الأخطاء وإصلاحها.
