작업 피드

작업 피드 만들기 및 업로드하기

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

• 작업 데이터 파일의 경우 작업 피드에 설명된 사양을 따릅니다. 업로드마다 고유한 작업 데이터 파일 이름을 사용하는 것이 좋습니다. 파일 이름에 타임스탬프를 포함합니다(예: action_1633621547.json).
• 파일 세트 설명자에서 name 필드를 reservewithgoogle.action.v2로 설정합니다. 설명자 파일의 예시는 JSON 샘플을 참고하세요. 업로드마다 고유한 설명자 파일 이름을 사용하는 것이 좋습니다. 파일 이름에 타임스탬프를 포함합니다(예: action_1633621547.filesetdesc.json). 설명자 파일을 일반 SFTP 서버에 업로드해야 합니다.
• 일반 SFTP 서버에 피드를 매일 전체 새로고침으로 업로드합니다.
• SFTP 서버 세부정보는 파트너 포털의 구성 > 피드 섹션에서 확인할 수 있습니다.



파트너 포털에서 피드 서버 선택하기

• 파트너 포털의 피드 > 기록 섹션에서 피드 처리 상태를 확인합니다.

정의

참고: 작업 피드 사양은 다음과 같이 프로토버퍼 형식으로 정의되지만 JSON 형식으로 피드를 업로드하는 것이 좋습니다. 자세한 내용은 JSON 샘플 피드를 참고하세요.

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

작업 피드 샘플

배송만

파일 이름 : actions_1697754089_0001.json

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

테이크아웃만 가능

파일 이름 : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [{ "food_ordering_info": { "service_type": "TAKEOUT" } }],
      "entity_id": "dining-1",
      "link_id": "takeout-link-dining-1",
      "url": "https://www.restaurant.com/takeout/dining-1"
    }
  ]
}

배달 및 테이크아웃

파일 이름 : actions_1697754089_0001.json

{
  "data": [
    {
      "actions": [
        { "food_ordering_info": { "service_type": "DELIVERY" } },
        { "food_ordering_info": { "service_type": "TAKEOUT" } }
      ],
      "entity_id": "dining-1",
      "link_id": "common-link-dining-1",
      "url": "https://www.restaurant.com/commonlink/dining-1"
    }
  ]
}

배달+테이크아웃 URL이 다름

파일 이름 : actions_1697754089_0001.json

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

설명자 파일

파일 이름 : actions_1697754089.filesetdesc.json

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