Enviar solicitud de API Admin

La acción Enviar solicitud de API Admin envía una mutación a la API Shopify GraphQL Admin. Al hacerlo, puedes realizar casi cualquier acción que la API permita al usar Flow.

Campos

La acción Enviar solicitud de API Admin contiene los siguientes campos.

Campos utilizados en la acción Enviar solicitud de API Admin.

Campo	Descripción
Mutación	Obligatorio. La mutación Shopify GraphQL Admin que deseas llamar. Una mutación es una API que ejecuta acciones o actualiza datos.
Entradas de mutación	Obligatorio. Los datos (en JSON) que debes enviar como parte de la solicitud de mutación. Cada mutación requiere un conjunto de datos diferente, que se documenta en el enlace proporcionado para cada mutación. Para construir el JSON necesario, puedes usar Liquid o la acción Ejecutar código.

Activadores

La acción Enviar solicitud de API Admin puede usarse en cualquier flujo de trabajo, con cualquier activador, siempre y cuando el flujo de trabajo proporcione los datos necesarios para construir las entradas de mutación.

Ejemplos

Ejemplo 1: Modifica la plantilla utilizada para un producto

En este ejemplo, usaremos la acción Enviar solicitud de API Admin para llamar a la mutación productUpdate a fin de actualizar la plantilla utilizada para un producto.

El campo id es obligatorio y debe ser un GID de producto válido. Aquí, lo establecemos con la variable {{product.id}} de Liquid. Este ejemplo supone que el flujo de trabajo tiene un activador que proporciona un objeto de producto.

templateSuffix es el nombre de la plantilla que deseas aplicar al producto. Por ejemplo, si deseas aplicar la plantilla pre-order, deberías establecer templateSuffix como pre-order.

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

Ejemplo 2: Actualiza el estado de exención de impuestos de un cliente

En este ejemplo, usaremos la acción Enviar solicitud de API Admin para llamar a la mutación customerUpdate a fin de actualizar la exención de impuestos de un cliente.

El campo id es obligatorio y debe ser un GID de cliente válido. Aquí, lo establecemos con la variable {{order.customer.id}} de Liquid. Este ejemplo supone que el flujo de trabajo tiene un activador que proporciona un objeto de pedido.

El campo taxExempt es un booleano que indica si el cliente está exento de impuestos. En este ejemplo, lo establecemos como true.

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

Ejemplo 3: Actualiza la configuración regional de un cliente

En este ejemplo, usaremos la acción Enviar solicitud de API Admin para llamar a la mutación customerUpdate a fin de actualizar la configuración regional de un cliente.

El campo id es obligatorio y debe ser un GID de cliente válido. Aquí, lo establecemos con la variable {{customer.id}} de Liquid. Este ejemplo supone que el flujo de trabajo tiene un activador que proporciona un objeto de cliente.

El campo locale es una cadena que representa la configuración regional del cliente. En este ejemplo, lo establecemos como en.

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

Limitaciones

La acción Enviar solicitud de API Admin tiene las siguientes limitaciones:

• No devuelve datos al entorno de Flow como resultado de la mutación.
• No admite consultas de GraphQL, solo mutaciones.
• No admite mutaciones asíncronas o que devuelvan un tipo Job.
• La acción no admite mutaciones específicas de ciertas aplicaciones, incluidas las mutaciones de suscripciones y de descuento.
• Mostrará una lista de Mutations y Mutation inputs de una sola versión de la API de Shopify, que actualmente es 2024-01.
• Cuando la versión de la API se actualiza y contiene un cambio importante, puede hacer que esta acción falle si recurres a ese campo.