فید نهاد

فیدهای Entity را ایجاد و آپلود کنید

وقتی فیدهای Entity را ایجاد و آپلود می‌کنید، مطمئن شوید که این دستورالعمل‌ها را دنبال می‌کنید:

• مشخصات شرح داده شده در فید Entity برای فایل های داده Entity را دنبال کنید. شما باید از نام‌های منحصر به فرد فایل داده Entity بین آپلودها استفاده کنید. توصیه می شود در نام فایل یک مهر زمانی قرار دهید، به عنوان مثال، Entity1_1633621547.json .
• در توصیفگر مجموعه فایل، فیلد name را روی reservewithgoogle.entity تنظیم کنید. برای مثالی از فایل توصیفگر، به نمونه JSON فایل توصیفگر مراجعه کنید. شما باید از نام های فایل توصیف کننده منحصر به فرد بین آپلودها استفاده کنید. توصیه می شود در نام فایل یک مهر زمانی اضافه کنید، به عنوان مثال، Entity1_1633621547.filesetdesc.json . فایل توصیفگر باید در dropbox عمومی SFTP آپلود شود.
• فیدها باید روزانه به عنوان بازخوانی کامل در Dropbox عمومی SFTP آپلود شوند.
• می‌توانید اطلاعات دراپ‌باکس SFTP فید عمومی را در بخش پیکربندی > فیدها در پورتال شریک پیدا کنید.



• می‌توانید وضعیت مصرف خوراک عمومی را در بخش Feeds > History پورتال شریک پیدا کنید.

تعاریف

توجه: مشخصات فید موجودیت در قالب پروتوبافر به صورت زیر تعریف می‌شود، با این حال توصیه می‌کنیم فیدها را با فرمت JSON آپلود کنید. برای اطلاعات بیشتر، به فیدهای نمونه JSON مراجعه کنید.

تعریف EntityFeed

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;
}

تعریف مختصات جغرافیایی

// 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"]
}