Method: attributes.list

تعرض قائمة بالسمات المتاحة التي ستكون متاحة لموقع جغرافي يتضمّن الفئة الأساسية والبلد المحدّدَين.

طلب HTTP

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

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

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

المَعلمات
name

string

اسم مورد الموقع الجغرافي للبحث عن السمات المتاحة

categoryId

string

المعرّف الثابت للفئة الأساسية للعثور على السمات المتاحة.

country

string

رمز البلد بصيغة ISO 3166-1 alpha-2 للبحث عن السمات المتاحة.

languageCode

string

رمز اللغة BCP 47 للحصول على أسماء عرض السمات. إذا لم تكن هذه اللغة متاحة، سيتم توفيرها باللغة الإنجليزية.

pageSize

integer

عدد السمات المطلوب تضمينها في كل صفحة القيمة التلقائية هي 200، والحد الأدنى هو 1.

pageToken

string

في حال تحديد هذه السمة، يتم استرداد الصفحة التالية من البيانات الوصفية للسمة. يتم عرض pageToken عندما تؤدي استدعاء attributes.list إلى عرض نتائج أكثر مما يمكن أن يلائم حجم الصفحة المطلوب.

نص الطلب

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

نص الاستجابة

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

رسالة استجابة لـ Locations.ListAttributeMetadata.

تمثيل JSON
{
  "attributes": [
    {
      object (AttributeMetadata)
    }
  ],
  "nextPageToken": string
}
الحقول
attributes[]

object (AttributeMetadata)

مجموعة من البيانات الوصفية للسمات المتاحة.

nextPageToken

string

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

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

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

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

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