يوضِّح لك هذا الدليل التوجيهي كيفية التعامل مع بيانات الحساب. تتيح لك واجهة برمجة تطبيقات إدارة حساب نشاطي التجاري القدرة على تنفيذ ما يلي:
- عرض قائمة بجميع الحسابات
- إرجاع حساب محدد.
- تعديل حساب
قبل البدء
قبل استخدام واجهة برمجة التطبيقات لإدارة حساب نشاطي التجاري، عليك تسجيل طلبك والحصول على بيانات اعتماد OAuth 2.0.
للحصول على تفاصيل عن كيفية بدء استخدام واجهات برمجة تطبيقات الملف التجاري، يُرجى الاطّلاع على الإعداد الأساسي.
سرد جميع الحسابات
هناك طريقة رائعة للتحقق من صحة الحسابات المرتبطة بالمستخدم الذي تمت مصادقته، وهي إدراج جميع حساباته. استخدِم واجهة برمجة التطبيقات accounts.list
لإدراج جميع الحسابات المرتبطة بمستخدم.
لعرض قائمة بجميع الحسابات لمستخدم تمت مصادقته، استخدِم ما يلي:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts
إرجاع حساب محدد
وقد تحتاج أحيانًا إلى الاطلاع على معلومات حول حساب محدد لمستخدم تمت المصادقة عليه. يمكنك استخدام واجهة برمجة التطبيقات accounts.get
لإرجاع حساب محدّد ومراجعة تفاصيل الحساب الإضافية.
لإرجاع حساب معيّن حسب الاسم، استخدِم ما يلي:
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}
تعديل حساب
يعد تغيير اسم الحساب مهمة إدارية أساسية. يمكنك استخدام
accounts.update
API لتغيير
اسم الحساب.
لتعديل حساب معيّن حسب الاسم، استخدِم ما يلي:
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId} { "account": { "accountName": "Anne Droyd" }, "languageCode": "en", "validateOnly": "true" }
القيود
- الحقل الوحيد القابل للتعديل في الحساب هو
accountName
. ويتم تجاهل أي حقول أخرى تم تمريرها. - لا يمكن تعديل سوى الحسابات من النوع
BUSINESS
بهذه الطريقة.