استخدام بيانات الحساب

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

• عرض قائمة بجميع الحسابات
• إرجاع حساب محدد.
• تعديل حساب

قبل البدء

قبل استخدام واجهة برمجة التطبيقات لإدارة حساب نشاطي التجاري، عليك تسجيل طلبك والحصول على بيانات اعتماد 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 بهذه الطريقة.