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

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

• أدرِج جميع الحسابات.
• إرجاع حساب محدّد
• تعديل حساب

قبل البدء

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

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

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

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

لإدراج جميع حسابات مستخدم تمت مصادقته، يمكنك استخدام ما يلي:

بروتوكول HTTP

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

إرجاع حساب محدّد

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

لإرجاع حساب معين بالاسم، استخدم ما يلي:

بروتوكول HTTP

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

تعديل حساب

تغيير اسم الحساب هو مهمة إدارية أساسية. يمكنك استخدام accounts.update API لتغييرها اسم الحساب.

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

بروتوكول HTTP

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

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

القيود

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