خلاصة العنصر

إنشاء خلاصات الكيانات وتحميلها

عند إنشاء خلاصات "الكيانات" وتحميلها، تأكَّد من اتّباع التعليمات التالية:

• اتّبِع المواصفات الموضّحة في خلاصة الكيان لملفات بيانات الكيان. يجب استخدام أسماء فريدة لملفات بيانات الكيان بين عمليات التحميل. يُنصح بتضمين طابع زمني في اسم الملف، مثل Entity1_1633621547.json.
• في واصف مجموعة الملفات، اضبط الحقل name على reservewithgoogle.entity. للاطّلاع على مثال على ملف الواصف، راجِع نموذج JSON لملف الواصف. يجب استخدام أسماء ملفات واصفة فريدة بين عمليات التحميل. يُنصح بتضمين طابع زمني في اسم الملف، مثل Entity1_1633621547.filesetdesc.json. يجب تحميل ملف الوصف إلى صندوق تحميل SFTP العام.
• يجب تحميل الخلاصات يوميًا على شكل عمليات إعادة تحميل كاملة إلى صندوق تحميل SFTP العام.
• يمكنك العثور على معلومات صندوق تحميل SFTP العامة للخلاصات في قسم الضبط > الخلاصات في بوابة الشركاء.



• يمكنك العثور على حالة عرض الخلاصة العامة في قسم الخلاصات > السجلّ في بوابة الشركاء.

التعريفات

ملاحظة: يتم تحديد مواصفات خلاصة الكيان في تنسيق النموذج الأوّلي على النحو التالي، ولكن ننصحك بتحميل الخلاصات بتنسيق JSON. لمزيد من المعلومات، يمكنك الاطّلاع على نماذج JSON لخلاصات.

تعريف "خلاصة العنصر"

message EntityFeed {
  repeated Entity data = 1;
}

تعريف الكيان

//
// Information about an Entity that is on the partner's platform. For example,
// an Entity could be a retail store, a hospital, an online business etc.
message Entity {
  // An opaque string generated by the partner that identifies an Entity.
  // Must be unique across all entities.
  // Strongly recommended to only include URL-safe characters. (required)
  string entity_id = 1;

  // If present, the name, telephone, url and location are used to support
  // matching partner inventory with entities already present on Google. This
  // information will not be displayed.

  // The name of the Entity. (required)
  string name = 2;

  // The contact telephone number of the Entity including its country and area
  // codes, e.g. [phone]. Highly recommended. (optional)
  string telephone = 3;

  // The url of the Entity's public website. Highly recommended. (optional)
  string url = 4;

  // The location of the Entity (required)
  madden.ingestion.GeoCoordinates location = 5;
}

تعريف GeoCoordinates

// The Geo data of a location, including latitude, longitude, and address.
// At least one of [lat/lng or address] should be provided (or both).
message GeoCoordinates {
  double latitude = 1;   // In degrees. (optional)
  double longitude = 2;  // In degrees. (optional)

  // Address for a location, could either be structured or unstructured.
  oneof addresses {
    // Postal address of the location, preferred.
    PostalAddress address = 3;
    // An unstructured address could also be provided as a fallback.
    // E.g. "1600 amphitheatre parkway mountain view, ca 94043"
    string unstructured_address = 4;
  }
}

تعريف العنوان البريدي

// The postal address for a merchant.
message PostalAddress {
  // The country, using ISO 3166-1 alpha-2 country code, e.g. "US" (required)
  string country = 1;
  // The locality/city, e.g. "Mountain View". (required)
  string locality = 2;
  // The region/state/province, e.g. "CA". This field is only required in
  // countries where region is commonly a part of the address. (optional)
  string region = 3;
  // The postal code, e.g. "94043". (required)
  string postal_code = 4;
  // The street address, e.g. "1600 Amphitheatre Pkwy". (required)
  string street_address = 5;
}

نماذج خلاصة الكيانات

خلاصة الكيان

اسم الملف : Entity1_1697754089.json

{
  "data": [
    {
      "entity_id": "dining-1",
      "name": "Cucina Venti Restaurant",
      "telephone": "[phone]",
      "url": "www.cucinaventi.com",
      "location": {
        "latitude": 37.41611,
        "longitude": -122.07751,
        "address": {
          "country": "US",
          "locality": "Mountain View",
          "region": "CA",
          "postal_code": "94043",
          "street_address": "1390 Pear Ave ste D"
        }
      }
    }
  ]
}

ملف الواصف

اسم الملف : entity1_1697754089.filesetdesc.json

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.entity",
  "data_file": ["entity1_1697754089.json"]
}