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
nareservewithgoogle.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
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"] }