Pošalji zahtev za Admin API

Radnja Pošalji zahtev za Admin API može da koristi većinu mutacija u GraphQL Admin API-ju za unošenje promena u vašoj prodavnici, uključujući mutacije koje još uvek nisu dostupne kao radnje u aplikaciji Flow.

Na ovoj stranici

Polja

Radnja Pošalji zahtev za Admin API sadrži sledeća polja.

Polja koja se koriste u radnji Pošalji zahtev za Admin API.
Polje	Opis
Mutacija	Obavezno. Shopify GraphQL Admin mutacija koju želite da pozovete. mutacija je API koji obavlja radnju ili ažurira podatke.
Unosi mutacije	Obavezno. Podaci (u JSON formatu) koje treba da pošaljete u okviru zahteva mutacije. Svaka mutacija zahteva drugačiji skup podataka, što je dokumentovano na linku priloženom za svaku mutaciju. Za kreiranje potrebnog JSON formata, možete da koristite Liquid ili radnju Pokreni kod.

Okidači

Radnja Send Admin API request se može koristiti u svakom toku posla, sa bilo kojim okidačem, sve dok taj tok posla pruža podatke neophodne za konstruisanje unosa mutacije.

Primeri

Primer 1: Ažuriranje šablona koji se koristi za proizvod

U ovom primeru koristićemo radnju Send Admin API request za pozivanje mutacije productUpdate radi ažuriranja šablona koji se koristi za proizvod.

Polje id je obavezno i mora biti važeći GID proizvoda. Ovde ga podešavamo pomoću Liquid promenljive {{product.id}}. Ovo pretpostavlja da vaš tok posla ima okidač koji pruža objekat proizvoda.

templateSuffix je naziv šablona koji želite da primenite na proizvod. Na primer, ako želite da primenite šablon pre-order, podesite templateSuffix na pre-order.

{
  "input": {
    "templateSuffix": "pre-order",
    "id": "{{product.id}}"
  }
}

Primer 2: Ažuriranje statusa oslobođenja od poreza za kupca

U ovom primeru koristićemo radnju Send Admin API request za pozivanje mutacije customerUpdate radi ažuriranja statusa oslobođenja od poreza za kupca.

Polje id je obavezno i mora biti važeći GID kupca. Ovde ga podešavamo pomoću Liquid promenljive {{order.customer.id}}. Ovo pretpostavlja da vaš tok posla ima okidač koji pruža objekat porudžbine.

Polje taxExempt je logička vrednost koja označava da li je kupac oslobođen od poreza. U ovom primeru ga podešavamo na true.

{
  "input": {
    "id": "{{order.customer.id}}",
    "taxExempt": true
  }
}

Primer 3: Ažuriranje lokaliteta kupca

U ovom primeru koristićemo radnju Send Admin API request za pozivanje mutacije customerUpdate radi ažuriranja lokaliteta kupca.

Polje id je obavezno i mora biti važeći GID kupca. Ovde ga podešavamo pomoću Liquid promenljive {{customer.id}}. Ovo pretpostavlja da vaš tok posla ima okidač koji pruža objekat kupca.

Polje locale je string koji predstavlja lokalitet kupca. U ovom primeru ga podešavamo na en.

{
  "input": {
    "id": "{{customer.id}}",
    "locale": "en"
  }
}

Liquid saveti

Flow podržava Liquid filter json koji može biti koristan prilikom konstruisanja unosa. Svi sledeći primeri koriste mutaciju customerUpdate i pretpostavljaju da vaš tok posla ima okidač koji pruža objekat kupca.

Rad sa stringovima

Sledeći primer ažurira napomenu za kupca:

{% assign revisedNote = customer.note | append: " Hello from Flow!" %}

{
  "input": {
    "id": "{{ customer.id }}",
    "note": {{ revisedNote | json }},
  }
}

Filter json vrši izlaz (escape) za string da bi obezbedio ispravan JSON format. Ovo rezultira sledećim JSON formatom nakon izvršavanja toka posla:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "note": "Had a \"great experience\" with their latest order. Hello from Flow!",
  }
}

Rad sa nizovima

Primer niza

Filter json transformiše Liquid niz u JSON niz. Sledeći primer izbacuje JSON niz kada mu se prosledi Liquid niz:

{% assign tags = "tag1,tag2,tag3" | split: "," %}

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": {{ tags | json }}
  }
}

Ovo rezultira sledećim JSON formatom nakon izvršavanja toka posla:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": ["tag1","tag2","tag3"]
  }
}

Primer For petlje

Sledeći primer koristi petlju za izlaz elemenata niza odvojenih zarezima:

{% assign tags = "tag1,tag2,tag3" | split: "," %}

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": [
      {% for tag in tags %}
        "{{ tag }}"{% unless forloop.last %},{% endunless %}
      {% endfor %}
    ]
  }
}

Ovo rezultira sledećim JSON formatom kada se izvrši tok posla:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": [
        "tag1",
        "tag2",
        "tag3"
    ]
  }
}

Primer filtera Map

Filter map se može koristiti za dobijanje niza određenog svojstva iz niza objekata. U sledećem primeru, niz svojstava city se izdvaja iz niza adresa kupaca:

{
  "input": {
    "id": "{{ customer.id }}",
    "tags": {{ customer.addresses | map: "city" | json }}
  }
}

Ovo rezultira sledećim JSON formatom nakon izvršavanja toka posla:

{
  "input": {
    "id": "gid://shopify/Customer/1234",
    "tags": ["Ottawa","Toronto"]
  }
}

Ograničenja

Radnja Send Admin API request ima sledeća ograničenja:

Radnja će prikazati listu Mutations i Mutation inputs iz verzije Admin API-ja koju koristi Flow.
Kada se objave nove verzije API-ja, ova radnja može biti neuspešna ako koristi mutaciju ili polje koje je promenjeno ili zastarelo.
Radnja ne podržava GraphQL upite, već samo mutacije.
Radnja ne podržava mutacije koje su zastarele.
Radnja ne podržava određene mutacije koje su specifične za pojedine aplikacije, uključujući neke mutacije za pretplatu, marketinške aktivnosti i popuste.
Radnja ne podržava asinhrone mutacije ni mutacije koje vraćaju tip Job.
Radnja ne podržava mutacije koje ne primenjuju interfejs čvora.

Šabloni

Dodajte besplatnu (100% popusta) stavku novim porudžbinama

Ovaj šablon dodaje besplatnu, sniženu stavku novim porudžbinama ako je stavka na zalihama. Proverava zalihe, primenjuje popust od 100% i ažurira porudžbinu bez obaveštavanja kupca. Ova automatizacija može biti korisna za (1) poboljšanje zadovoljstva kupaca uključivanjem besplatnog predmeta iznenađenja u njihovu porudžbinu, (2) promovisanje novih ili manje poznatih proizvoda njihovim dodavanjem kao besplatnih uzoraka u porudžbine ili (3) olakšavanje promocija automatizacijom uključivanja i sniženja besplatnih stavki. Prikaži šablon

Dozvolite naručivanje kompanijama koje su kreirane preko zahteva za nalog kompanije

Dodelite dozvolu za naručivanje kada se kompanija kreira putem zahteva za nalog kompanije. Prikaži šablon

Promenite šablon proizvoda kada varijante nisu na zalihama ili su ponovo na zalihama

Ažurirajte šablon proizvoda na osnovu zaliha za varijante proizvoda. Ovaj tok posla vam omogućava da se prebacujete između šablona za proizvode na zalihama (podrazumevani šablon prodavnice), proizvode kojih nema na zalihama, i onih kada jedne ili više varijanti nema na zalihama. Prikaži šablon

Realizujte sve digitalne stavke u porudžbini

Realizuje sve stavke za koje nije potrebna fizička dostava, kao što su digitalne stavke, ili koje se podudaraju sa listom SKU-ova. Izvršava se jednom za svaku lokaciju realizacije („porudžbina za realizaciju”) za novu porudžbinu. Prikaži šablon