작업 피드

작업 피드 만들기 및 업로드

작업 피드를 만들고 업로드할 때 다음 안내를 따르세요.

  • 작업 데이터 파일은 작업 피드에 설명된 사양을 따르세요. 업로드 간에 고유한 작업 데이터 파일 이름을 사용해야 합니다. 파일 이름에 타임스탬프(예: 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"]
}