Kanał działań

Tworzenie i przesyłanie plików danych działań

Podczas tworzenia i przesyłania plików danych zachęcających do działania postępuj zgodnie z tymi instrukcjami:

  • Postępuj zgodnie ze specyfikacją opisaną w kanał działań plików z danymi działań. Między przesyłaniem plików musisz używać unikalnych nazw plików z danymi o działaniach. Zaleca się dodanie do nazwy pliku sygnatury czasowej, np. action1_1633621547.json.
  • W deskryptorze zbioru plików w polu name ustaw wartość reservewithgoogle.action.v2 Przykład pliku deskryptora znajdziesz w przykładzie pliku JSON z deskryptorem. W trakcie przesyłania musisz używać unikalnych nazw plików deskryptorów. Zaleca się dodanie do nazwy pliku sygnatury czasowej, np. action1_1633621547.filesetdesc.json. Plik deskryptora należy przesłać do ogólnej skrzynki referencyjnej SFTP.
  • Pliki danych muszą być codziennie przesyłane do ogólnej skrzynki referencyjnej SFTP jako pełne odświeża się.
  • Ogólne informacje o skrzynce referencyjnej SFTP znajdziesz w Konfiguracja > Pliki danych w portalu dla partnerów.

    • Wybieranie skrzynek referencyjnych

  • Ogólny stan przetwarzania kanału znajdziesz w Kanały > Historia w portalu dla partnerów.

Definicje

Definicja pliku ActionFeed

message ActionFeed {
  repeated ActionDetail data = 1;
}

Definicja elementu ActionDetails

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 jedzenia zamawiania informacje

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 pliku danych działań

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 i z dostawą

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 + jedzenie na wynos – 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"]
}
Wstecz
Plik danych elementu
Dalej
Plik danych usługi