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

توضّح لك هذه المقالة التعليمية كيفية العمل مع بيانات الحساب. تتيح لك واجهة برمجة التطبيقات My Business Account Management API تنفيذ ما يلي:

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

قبل البدء

قبل استخدام واجهة برمجة التطبيقات My Business Account Management API، عليك تسجيل تطبيقك والحصول على بيانات اعتماد OAuth 2.0.

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

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

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

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

بروتوكول HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts

عرض حساب معيّن

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

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

بروتوكول HTTP
$ GET https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

تعديل حساب

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

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

بروتوكول HTTP
$ PUT https://mybusinessaccountmanagement.googleapis.com/v1/accounts/{accountId}

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

القيود

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