Plik danych o działaniach

Tworzenie i przesyłanie plików danych o działaniach

Podczas tworzenia i przesyłania plików danych o działaniach postępuj zgodnie z tymi instrukcjami:

• W przypadku plików danych o działaniach postępuj zgodnie ze specyfikacją opisaną w pliku danych o działaniach. Zalecamy używanie unikalnych nazw plików danych o działaniach w przypadku każdego przesyłania. Uwzględnij w nazwie pliku sygnaturę czasową, na przykład action_1633621547.json.
• W deskryptorze zbioru plików ustaw pole name na reservewithgoogle.action.v2. Przykładowy plik deskryptora znajdziesz w przykładzie JSON. Zalecamy używanie unikalnych nazw plików deskryptorów przy każdym przesyłaniu. Uwzględnij w nazwie pliku sygnaturę czasową, na przykład action_1633621547.filesetdesc.json. Plik deskryptora musi zostać przesłany na ogólny serwer SFTP.
• Codziennie przesyłaj pliki danych na ogólny serwer SFTP jako pełne odświeżenia.
• Szczegóły serwera SFTP znajdziesz w sekcji Konfiguracja > Pliki danych w Portalu dla partnerów.



• Stan przetwarzania pliku danych możesz sprawdzić w sekcji Przetwarzanie > Historia w Portalu dla partnerów.

Definicje

Definicja ActionFeed

message ActionFeed {
  option features.(pb.java).nest_in_file_class = YES;

  repeated ActionDetail data = 1;
}

Definicja ActionDetail

message ActionDetail {
  option features.(pb.java).nest_in_file_class = YES;

  string entity_id = 2;
  string link_id = 3;

  // Deep link for action detail
  string url = 4;

  // The actions that can be performed using this deep link. At least one
  // Action must be specified.
  repeated Action actions = 1;
}

Definicja działania

// Information about an Action which could be performed.
message Action {
  option features.(pb.java).nest_in_file_class = YES;

  // Deprecated fields not to be reused.
  reserved 1;

  oneof action_info {
    AppointmentInfo appointment_info = 2;

  }
}

Definicja AppointmentInfo

// Indicates that the parent Action is for booking an appointment.
// In v2 of the Action feed, the deep link URL is specified on ActionDetail.url,
// so this message has no fields and should be set as an empty object
// (for example, "appointment_info": {} in JSON).
message AppointmentInfo {
  option features.(pb.java).nest_in_file_class = YES;

}

Przykłady plików danych o działaniach

{
  "data": [
    {
      "entity_id": "appointments-merchant-1",
      "link_id": "appointment-link-1",
      "url": "https://www.partnerwebsite.com/appointment/appointment-partner-1",
      "actions":[
        {
          "appointment_info": {}
        }
      ]
    }
  ]
}

{
  "generation_timestamp": 1677540395,
  "name": "reservewithgoogle.action.v2",
  "data_file": [
    "action_1677540395_0001.json",
    "action_1677540395_0002.json"

  ]
}