العمل مع بيانات الحساب

يوضِّح لك هذا البرنامج التعليمي كيفية العمل مع بيانات الحساب. تمنحك واجهة برمجة التطبيقات لإدارة حساب "نشاطي التجاري" إمكانية تنفيذ ما يلي:

• عرض جميع الحسابات
• عرض حساب محدّد
• تعديل حساب

قبل البدء

قبل استخدام واجهة برمجة التطبيقات لإدارة حساب "نشاطي التجاري"، عليك تسجيل تطبيقك والحصول على بيانات اعتماد OAuth 2.0.

للحصول على تفاصيل حول كيفية بدء استخدام واجهات برمجة التطبيقات للملفات التجارية، يمكنك الاطّلاع على مقالة الإعداد الأساسي.

عرض جميع الحسابات

من الطرق الرائعة للتحقّق من صحة الحسابات المرتبطة بمستخدم تمّت المصادقة عليه هي عرض جميع حساباته. استخدِم واجهة برمجة التطبيقات accounts.list لعرض جميع الحسابات المرتبطة بمستخدم.

لعرض جميع حسابات مستخدم تمّت المصادقة عليه، استخدِم ما يلي:

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

عرض حساب محدّد

في بعض الأحيان، قد تريد الاطّلاع على معلومات حول حساب محدّد فقط لمستخدم تمّت المصادقة عليه. استخدِم واجهة برمجة التطبيقات accounts.get لعرض حساب محدّد ومراجعة تفاصيل الحساب الإضافية.

لعرض حساب محدّد بالاسم، استخدِم ما يلي:

$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

تعديل حساب

يُعدّ تغيير اسم الحساب مهمة إدارية أساسية. استخدِم واجهة برمجة التطبيقات accounts.update لتغيير اسم الحساب.

لتعديل حساب محدّد بالاسم، استخدِم ما يلي:

$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

{
  "account": {
    "accountName": "Anne Droyd"
  },
  "languageCode": "en",
  "validateOnly": "true"
}

القيود

• accountName هو الحقل الوحيد القابل للتعديل في الحساب. ويتم تجاهل أي حقول أخرى يتم تمريرها.
• لا يمكن تعديل الحسابات من النوع BUSINESS بهذه الطريقة.