Kanał działań

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

Podczas tworzenia i przesyłania plików danych o działaniach upewnij się, że postępujesz zgodnie z tymi instrukcjami:

• Pliki z danymi działań muszą być zgodne ze specyfikacją opisaną w pliku danych o działaniach. Między przesyłanymi plikami musisz używać unikalnych nazw plików danych działań. Zalecamy umieszczenie w nazwie pliku sygnatury czasowej, np. action1_1633621547.json.
• W deskryptorze zbioru plików ustaw pole name na reservewithgoogle.action.v2. Przykład pliku deskryptora znajdziesz w tym artykule w formacie JSON. Między przesyłanymi plikami musisz używać unikalnych nazw plików z deskryptorami. Zalecamy umieszczenie w nazwie pliku sygnatury czasowej, np. action1_1633621547.filesetdesc.json. Plik z deskryptorem należy przesłać do ogólnej skrzynki referencyjnej SFTP.
• Pliki danych należy codziennie przesyłać do ogólnej skrzynki referencyjnej SFTP.
• Ogólne informacje o skrzynce referencyjnej SFTP znajdziesz w sekcji Konfiguracja > Pliki danych w portalu dla partnerów.



• Ogólny stan przetwarzania kanału znajdziesz w portalu dla partnerów w sekcji Pliki danych > Historia.

Definicje

Uwaga: specyfikacja pliku danych działań definiuje się w ten sposób, ale zalecamy przesyłanie plików danych w formacie JSON. Więcej informacji znajdziesz na stronie przykładowych plików danych JSON.

Definicja pliku danych działań

message ActionFeed {
  repeated ActionDetail data = 1;
}

Definicja elementu Actiondetail

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

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

Definicja działania

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

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

Przykłady plików danych o działaniach

Tylko dostawa

Nazwa pliku : 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"
    }
  ]
}

Tylko zamówienia na wynos

Nazwa pliku : 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"
    }
  ]
}

Na wynos z dostawą i jedzeniem

Nazwa pliku : 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"
    }
  ]
}

Dostawa i eksportowanie – inny adres URL

Nazwa pliku : 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"
    }
  ]
}

Plik deskryptora

Nazwa pliku : actions1_1697754089.filesetdesc.json

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