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.