تتضمّن واجهة برمجة التطبيقات
لأداء الأعمال في Google طريقة واجهة برمجة تطبيقات
جديدة تتيح جلب عدة "مقاييس يومية" في طلب واحد لواجهة برمجة التطبيقات.
يُرجى مراجعة
الجدول الزمني للإيقاف وتعليمات نقل البيانات من طريقة v4 reportInsights API إلى واجهة برمجة التطبيقات الخاصة بأداء "الملف التجاري على Google".
REST Resource: accounts.admins
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
المورد: المشرف
مشرف حساب أو موقع جغرافي.
| تمثيل JSON |
{
"name": string,
"admin": string,
"account": string,
"role": enum (AdminRole),
"pendingInvitation": boolean
} |
| الحقول |
name |
string
غير قابل للتغيير. اسم المورد. بالنسبة إلى مشرفي الحساب، يكون هذا بالتنسيق: accounts/{account_id}/admins/{admin_id} بالنسبة إلى مشرفي المواقع الجغرافية، يكون هذا بالتنسيق: locations/{locationId}/admins/{admin_id} سيتم تجاهل هذا الحقل في حال ضبطه أثناء إنشاء حساب المشرف.
|
admin |
string
اختياريّ. اسم المشرف. عند إرسال الدعوة الأولى، يكون هذا العنوان هو عنوان البريد الإلكتروني للمدعو. في مكالمات GET، يتم عرض عنوان البريد الإلكتروني للمستخدم إذا كانت الدعوة لا تزال في انتظار المراجعة. وبخلاف ذلك، يحتوي على الاسم الأول واسم العائلة للمستخدم. يجب ضبط هذا الحقل أثناء إنشاء حساب المشرف فقط.
|
account |
string
غير قابل للتغيير. اسم مورد "الحساب" الذي يشير إليه هذا المشرف. يتم استخدامه عند الاتصال بـ location.admins.create لدعوة موقع LocationGroup كمشرف. في حال ضبط كل من هذا الحقل وadmin على طلبات CREATE، تكون الأولوية لهذا الحقل وسيتم تجاهل عنوان البريد الإلكتروني في admin. التنسيق: accounts/{account}
|
role |
enum (AdminRole)
مطلوب. تُحدِّد الدور الذي يستخدمه هذا المشرف مع الحساب أو الموقع الجغرافي المحدّد.
|
pendingInvitation |
boolean
النتائج فقط. يشير هذا العمود إلى ما إذا كان هذا المشرف لديه دعوة معلّقة للمورد المحدّد.
|
AdminRole
تشير إلى مستوى الوصول الذي يمتلكه المشرف. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة مركز المساعدة.
| عمليات التعداد |
ADMIN_ROLE_UNSPECIFIED |
لم يتم تحديده. |
PRIMARY_OWNER |
ويتمتع المشرف بإذن وصول على مستوى المالك، كما أنه المالك الأساسي. (يظهر على أنّه "المالك الأساسي" في واجهة المستخدم). |
OWNER |
يمتلك المشرف إذن وصول على مستوى المالك. (يظهر باسم "المالك" في واجهة المستخدم). |
MANAGER |
يمتلك المشرف إذن وصول إداري. |
SITE_MANAGER |
يمكن للمشرف إدارة صفحات الشبكات الاجتماعية (Google+ ). (يظهر باسم "مدير الموقع الجغرافي" في واجهة المستخدم). لا تسمح واجهة برمجة التطبيقات هذه بإنشاء مشرف حساب بدور SITE_MANAGER. |
الطُرق |
|
|
دعوة للمستخدم المحدّد ليصبح مشرفًا للحساب المحدّد |
|
|
إزالة المشرف المحدّد من الحساب المحدّد |
|
|
يسرد المشرفين على الحساب المحدّد. |
|
|
يتم تحديث "المشرف" لـ "مشرف الحساب" المحدّد. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eAn Admin is an administrator of an Account or a location with different access levels defined by \u003ccode\u003eAdminRole\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAdmins can have roles like Primary Owner, Owner, Manager, and Site Manager, each with varying permissions.\u003c/p\u003e\n"],["\u003cp\u003eYou can manage Admins by inviting, removing, listing, and updating them using the provided methods.\u003c/p\u003e\n"],["\u003cp\u003eAdmin details include name, role, account association, and pending invitation status, represented in JSON format.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eAdminRole\u003c/code\u003e enum defines the access level of an admin, impacting their capabilities within the account or location.\u003c/p\u003e\n"]]],["Account and location administrators, identified by a resource name, have roles like `PRIMARY_OWNER`, `OWNER`, `MANAGER`, or `SITE_MANAGER`. Admins can be created by inviting a user via email, and roles are set during creation. The `pendingInvitation` field shows if an invite is pending. Available actions include: creating, deleting, listing, and updating admin access. `Admin` field contains the invitee's email address initially or user details after accepting.\n"],null,[]]
