Cast Specification

Cast Specifications #

Trigger #

Conditions #

You can specify the following conditions:

  • When the detected data meets the conditions
    • Unconditional if not specified
    • AND condition when two or more are specified

Data conditions can be specified by the combination of key, comparison operator, and value. Note that different types allow different comparison operators.

  • string
    • ==
    • !=
  • number / integer
    • >
    • <
    • >=
    • <=
    • ==
  • boolean
    • ==

Actions #

Selectable actions #

Webhook and BigQuery are selectable types of Action currently available.

Webhook #

Webhook has the following parameters.

  • URL
    • required
    • Puts URL of Cast Target Service.
  • Method
    • required
  • Headers
    • can have multiple key-value pairs
    • Only Content-Type requires one of the values
      • application/json
      • application/x-www-form-urlencoded
      • text/plain
  • Body
    • JSON
    • Embedding data using templates
  • Rate Limit (s)
    • required
Template #

Actcast gets the value based on the variable name described in the template and embeds it in the Body. Use a template with double brackets ({{, }}) as follows:

{
  "label": "{{ data.label }}"
}
  • You can insert whitespaces in the double brackets (which are not saved)
  • Double brackets ({{,}}) cannot be escaped
  • Syntaxes such as loops and conditionals are not supported

You can check and select the available variables from Insert Variable menu.

See variables available in Casts for more details.

Rate Limit #

Set the lower limit of the interval (in seconds) for sending Cast. If you want not to limit requests, leave empty. (If the Cast Target Service doesn’t admit, you’ll get an error.)

For more details, see Rate Limit of Webhook Cast.

BigQuery #

BigQuery has the following parameters. Note that it cannot be used with BigQuery sandbox.

  • Table ID
    • required
    • Puts Table ID of BigQuery Table as Cast Target.
  • Service Account Key
    • required
    • JSON
    • Key of aervice account(BigQuery administrator role) for the project that has the table.
Table schema #

The schema of the BigQuery table to Cast to is fixed. However, the schema is different when receiving Act’s Cast and when receiving System Cast. For Cast, see BigQuery Table Schema. For System Cast, see BigQuery Table Schema (System Cast).

Notes #

About duplicate transmission of Cast of Act Log #

Act Log may be Cast more than once.

How to determine duplicate #

Act Log can be determined as a duplicate if all the following values are the same.

  • {{act_id}}
  • {{cast_id}}
  • {{detected_at}}
  • {{device.id}}
  • {{sequence_number}}
  • {{act_log_index}}

Back to Cast