خلاصة الإجراءات

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

عند إنشاء خلاصات الإجراءات وتحميلها، احرص على اتّباع التعليمات التالية:

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

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

التعريفات

تعريف ActionFeed

message ActionFeed {
  repeated ActionDetail data = 1;
}

تعريف ActionDetail

message ActionDetail {
  string entity_id = 2;
  string link_id = 3;

  // Deep link for action detail
  string url = 4;
  repeated Action actions = 1;
}

تعريف الإجراء

// Information about an Action which could be performed.
message Action {
  // Deprecated fields not to be reused.
  reserved 1;

  oneof action_info {
    FoodOrderingInfo food_ordering_info = 3;
  }
}

تعريف FoodOrderingInfo

message FoodOrderingInfo {
  // Service type for food ordering action.
  enum ServiceType {
    UNKNOWN = 0;
    DELIVERY = 1;
    TAKEOUT = 2;
  }

  ServiceType service_type = 1 [features.field_presence = IMPLICIT];
}

نماذج خلاصة الإجراءات

خدمة التوصيل فقط

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

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "DELIVERY" } }],
      "entity_id": "entity002",
      "link_id": "delivery_link/entity002",
      "url": "https://www.restaurant.com/delivery/entity002"
    }
  ]
}

تناول الأكل خارج المطعم فقط

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

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "TAKEOUT" } }],
      "entity_id": "entity002",
      "link_id": "takeout_link/entity002",
      "url": "https://www.restaurant.com/takeout/entity002"
    }
  ]
}

توصيل الطعام والطعام السفري

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

{
  "data": [
    {
      "actions": [
        { "food_ordering_info": { "service_type": "DELIVERY" } },
        { "food_ordering_info": { "service_type": "TAKEOUT" } }
      ],
      "entity_id": "entity002",
      "link_id": "common_link/entity002",
      "url": "https://www.restaurant.com/commonlink/entity002"
    }
  ]
}

عنوان URL مختلف للتسليم والتصدير

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

{
  "data": [
    {
      "actions": [
        {
          "food_ordering_info": {
            "service_type": "TAKEOUT"
          }
        }
      ],
      "entity_id": "entity002",
      "link_id": "takeout_link/entity002",
      "url": "https://www.restaurant.com/takeout/entity002"
    },
    {
      "actions": [
        {
          "food_ordering_info": {
            "service_type": "DELIVERY"
          }
        }
      ],
      "entity_id": "entity002",
      "link_id": "delivery_link/entity002",
      "url": "https://www.restaurant.com/delivery/entity002"
    }
  ]
}

ملف الواصف

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

{
  "generation_timestamp": 1697754089,
  "name": "reservewithgoogle.action.v2",
  "data_file": ["actions1_1697754089.json"]
}