Method: categories.list

تعرض قائمة بفئات الأنشطة التجارية. سيتطابق البحث مع اسم الفئة ولكن ليس معرّف الفئة.

طلب HTTP

GET https://mybusiness.googleapis.com/v4/categories

يستخدِم عنوان URL بنية تحويل ترميز gRPC.

معلمات طلب البحث

المَعلمات
regionCode

string

تمثّل هذه السمة رمز البلد بصيغة ISO 3166-1 alpha-2.
languageCode

string

تمثّل هذه السمة رمز اللغة BCP 47. إذا لم تكن اللغة متاحة، سيتم ضبط اللغة التلقائية على الإنجليزية.
searchTerm

string

سلسلة فلتر اختيارية من المستخدم
pageSize

integer

عدد الفئات المطلوب جلبها لكل صفحة. الإعداد التلقائي هو 100 والحد الأدنى هو 1 والحد الأقصى لحجم الصفحة هو 100.
pageToken

string

في حال تحديد ذلك، سيتم جلب الصفحة التالية من الفئات.
view

enum (CategoryView)

اختياريّ. تحدد الأجزاء إلى مورد الفئة التي يجب عرضها في الاستجابة.

نص الطلب

يجب أن يكون نص الطلب فارغًا.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "categories": [
    {
      object (Category)
    }
  ],
  "totalCategoryCount": integer,
  "nextPageToken": string
}
الحقول
categories[]

object (Category)

الفئات. الفئات هي عرض BASIC. لا تحتوي هذه الملفات على أي معلومات عن ServiceType.
totalCategoryCount

integer

إجمالي عدد الفئات لمعلمات الطلب.
nextPageToken

string

إذا تجاوز عدد الفئات حجم الصفحة المطلوب، ستتم تعبئة هذا الحقل برمز مميّز لجلب الصفحة التالية من الفئات عند استدعاء لاحق إلى categories.list.

نطاقات الأذونات

يتطلب استخدام أحد نطاقات OAuth التالية:

  • https://www.googleapis.com/auth/plus.business.manage
  • https://www.googleapis.com/auth/business.manage

لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.