実験を作成 - Auth0 Docs

using Auth0.ManagementApi;
using System.Threading.Tasks;
using Auth0.ManagementApi.Experimentation;
using System.Collections.Generic;

public partial class Examples
{
    public async Task Example() {
        var client = new ManagementApiClient(
            token: "<token>",
            clientOptions: new ClientOptions { BaseUrl = "https://{YOUR_DOMAIN}/api/v2" }
        );

        await client.Experimentation.Experiments.CreateAsync(
            new CreateExperimentRequestContent {
                Name = "name",
                FeatureFlagId = "feature_flag_id",
                AuthenticationFlow = "authentication_flow",
                AllocationStrategy = AllocationStrategyEnum.Percentage,
                AssignmentConfig = new AssignmentConfig {
                    Subject = SubjectEnum.Device
                },
                Allocations = new List<AllocationRequestItem>(){
                    new AllocationRequestItem {
                        VariationId = "variation_id",
                        IsControl = true
                    },
                }

            }
        );
    }

}

package com.example.usage;

import com.auth0.client.mgmt.ManagementApi;
import com.auth0.client.mgmt.experimentation.types.CreateExperimentRequestContent;
import com.auth0.client.mgmt.types.AllocationRequestItem;
import com.auth0.client.mgmt.types.AllocationStrategyEnum;
import com.auth0.client.mgmt.types.AssignmentConfig;
import com.auth0.client.mgmt.types.SubjectEnum;
import java.util.Arrays;

public class Example {
    public static void main(String[] args) {
        ManagementApi client = ManagementApi
            .builder()
            .domain("{YOUR_DOMAIN}")
            .token("<token>")
            .build();

        client.experimentation().experiments().create(
            CreateExperimentRequestContent
                .builder()
                .name("name")
                .featureFlagId("feature_flag_id")
                .authenticationFlow("authentication_flow")
                .allocationStrategy(AllocationStrategyEnum.PERCENTAGE)
                .assignmentConfig(
                    AssignmentConfig
                        .builder()
                        .subject(SubjectEnum.DEVICE)
                        .build()
                )
                .allocations(
                    Arrays.asList(
                        AllocationRequestItem
                            .builder()
                            .variationId("variation_id")
                            .isControl(true)
                            .build()
                    )
                )
                .build()
        );
    }
}

<?php

namespace Example;

use Auth0\SDK\API\Management\Wrapper\ManagementClient;
use Auth0\SDK\API\Management\Wrapper\ManagementClientOptions;
use Auth0\SDK\API\Management\Experimentation\Experiments\Requests\CreateExperimentRequestContent;
use Auth0\SDK\API\Management\Types\AllocationStrategyEnum;
use Auth0\SDK\API\Management\Types\AssignmentConfig;
use Auth0\SDK\API\Management\Types\SubjectEnum;
use Auth0\SDK\API\Management\Types\AllocationRequestItem;

$client = new ManagementClient(new ManagementClientOptions(
    domain: '{YOUR_DOMAIN}',
    token: '<token>',
));
$client->experimentation->experiments->create(
    new CreateExperimentRequestContent([
        'name' => 'name',
        'featureFlagId' => 'feature_flag_id',
        'authenticationFlow' => 'authentication_flow',
        'allocationStrategy' => AllocationStrategyEnum::Percentage->value,
        'assignmentConfig' => new AssignmentConfig([
            'subject' => SubjectEnum::Device->value,
        ]),
        'allocations' => [
            new AllocationRequestItem([
                'variationId' => 'variation_id',
                'isControl' => true,
            ]),
        ],
    ]),
);

from auth0.management import ManagementClient, AssignmentConfig, AllocationRequestItem

client = ManagementClient(
    domain="{YOUR_DOMAIN}",
    token="<token>",
)

client.experimentation.experiments.create(
    name="name",
    feature_flag_id="feature_flag_id",
    authentication_flow="authentication_flow",
    allocation_strategy="percentage",
    assignment_config=AssignmentConfig(
        subject="device",
    ),
    allocations=[
        AllocationRequestItem(
            variation_id="variation_id",
            is_control=True,
        )
    ],
)

require "auth0"

client = Auth0::Management.new(token: "<token>", base_url: "https://{YOUR_DOMAIN}/api/v2")

client.experimentation.experiments.create(
  name: "name",
  feature_flag_id: "feature_flag_id",
  authentication_flow: "authentication_flow",
  allocation_strategy: "percentage",
  assignment_config: {
    subject: "device"
  },
  allocations: [{
    variation_id: "variation_id",
    is_control: true
  }]
)

curl --request POST \
  --url https://{tenantDomain}/api/v2/experimentation/experiments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "allocations": [
    {
      "is_control": true,
      "variation_id": "<string>",
      "is_fallback": true,
      "priority": 2,
      "segment_id": "<string>",
      "weight": 50
    }
  ],
  "assignment_config": {
    "subject": "device"
  },
  "authentication_flow": "<string>",
  "feature_flag_id": "<string>",
  "name": "<string>",
  "description": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    allocations: [
      {
        is_control: true,
        variation_id: '<string>',
        is_fallback: true,
        priority: 2,
        segment_id: '<string>',
        weight: 50
      }
    ],
    assignment_config: {subject: 'device'},
    authentication_flow: '<string>',
    feature_flag_id: '<string>',
    name: '<string>',
    description: '<string>'
  })
};

fetch('https://{tenantDomain}/api/v2/experimentation/experiments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}/api/v2/experimentation/experiments"

	payload := strings.NewReader("{\n  \"allocations\": [\n    {\n      \"is_control\": true,\n      \"variation_id\": \"<string>\",\n      \"is_fallback\": true,\n      \"priority\": 2,\n      \"segment_id\": \"<string>\",\n      \"weight\": 50\n    }\n  ],\n  \"assignment_config\": {\n    \"subject\": \"device\"\n  },\n  \"authentication_flow\": \"<string>\",\n  \"feature_flag_id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"description\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "allocations": [
    {
      "is_control": true,
      "is_fallback": true,
      "priority": 123,
      "segment_id": "<string>",
      "variation_id": "<string>",
      "weight": 123
    }
  ],
  "assignment_config": {
    "subject": "device"
  },
  "authentication_flow": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "feature_flag_id": "<string>",
  "id": "<string>",
  "is_valid": true,
  "name": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "ended_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z"
}

POST

https://{tenantDomain}/api/v2

experimentation

experiments

using Auth0.ManagementApi;
using System.Threading.Tasks;
using Auth0.ManagementApi.Experimentation;
using System.Collections.Generic;

public partial class Examples
{
    public async Task Example() {
        var client = new ManagementApiClient(
            token: "<token>",
            clientOptions: new ClientOptions { BaseUrl = "https://{YOUR_DOMAIN}/api/v2" }
        );

        await client.Experimentation.Experiments.CreateAsync(
            new CreateExperimentRequestContent {
                Name = "name",
                FeatureFlagId = "feature_flag_id",
                AuthenticationFlow = "authentication_flow",
                AllocationStrategy = AllocationStrategyEnum.Percentage,
                AssignmentConfig = new AssignmentConfig {
                    Subject = SubjectEnum.Device
                },
                Allocations = new List<AllocationRequestItem>(){
                    new AllocationRequestItem {
                        VariationId = "variation_id",
                        IsControl = true
                    },
                }

            }
        );
    }

}

package com.example.usage;

import com.auth0.client.mgmt.ManagementApi;
import com.auth0.client.mgmt.experimentation.types.CreateExperimentRequestContent;
import com.auth0.client.mgmt.types.AllocationRequestItem;
import com.auth0.client.mgmt.types.AllocationStrategyEnum;
import com.auth0.client.mgmt.types.AssignmentConfig;
import com.auth0.client.mgmt.types.SubjectEnum;
import java.util.Arrays;

public class Example {
    public static void main(String[] args) {
        ManagementApi client = ManagementApi
            .builder()
            .domain("{YOUR_DOMAIN}")
            .token("<token>")
            .build();

        client.experimentation().experiments().create(
            CreateExperimentRequestContent
                .builder()
                .name("name")
                .featureFlagId("feature_flag_id")
                .authenticationFlow("authentication_flow")
                .allocationStrategy(AllocationStrategyEnum.PERCENTAGE)
                .assignmentConfig(
                    AssignmentConfig
                        .builder()
                        .subject(SubjectEnum.DEVICE)
                        .build()
                )
                .allocations(
                    Arrays.asList(
                        AllocationRequestItem
                            .builder()
                            .variationId("variation_id")
                            .isControl(true)
                            .build()
                    )
                )
                .build()
        );
    }
}

<?php

namespace Example;

use Auth0\SDK\API\Management\Wrapper\ManagementClient;
use Auth0\SDK\API\Management\Wrapper\ManagementClientOptions;
use Auth0\SDK\API\Management\Experimentation\Experiments\Requests\CreateExperimentRequestContent;
use Auth0\SDK\API\Management\Types\AllocationStrategyEnum;
use Auth0\SDK\API\Management\Types\AssignmentConfig;
use Auth0\SDK\API\Management\Types\SubjectEnum;
use Auth0\SDK\API\Management\Types\AllocationRequestItem;

$client = new ManagementClient(new ManagementClientOptions(
    domain: '{YOUR_DOMAIN}',
    token: '<token>',
));
$client->experimentation->experiments->create(
    new CreateExperimentRequestContent([
        'name' => 'name',
        'featureFlagId' => 'feature_flag_id',
        'authenticationFlow' => 'authentication_flow',
        'allocationStrategy' => AllocationStrategyEnum::Percentage->value,
        'assignmentConfig' => new AssignmentConfig([
            'subject' => SubjectEnum::Device->value,
        ]),
        'allocations' => [
            new AllocationRequestItem([
                'variationId' => 'variation_id',
                'isControl' => true,
            ]),
        ],
    ]),
);

from auth0.management import ManagementClient, AssignmentConfig, AllocationRequestItem

client = ManagementClient(
    domain="{YOUR_DOMAIN}",
    token="<token>",
)

client.experimentation.experiments.create(
    name="name",
    feature_flag_id="feature_flag_id",
    authentication_flow="authentication_flow",
    allocation_strategy="percentage",
    assignment_config=AssignmentConfig(
        subject="device",
    ),
    allocations=[
        AllocationRequestItem(
            variation_id="variation_id",
            is_control=True,
        )
    ],
)

require "auth0"

client = Auth0::Management.new(token: "<token>", base_url: "https://{YOUR_DOMAIN}/api/v2")

client.experimentation.experiments.create(
  name: "name",
  feature_flag_id: "feature_flag_id",
  authentication_flow: "authentication_flow",
  allocation_strategy: "percentage",
  assignment_config: {
    subject: "device"
  },
  allocations: [{
    variation_id: "variation_id",
    is_control: true
  }]
)

curl --request POST \
  --url https://{tenantDomain}/api/v2/experimentation/experiments \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "allocations": [
    {
      "is_control": true,
      "variation_id": "<string>",
      "is_fallback": true,
      "priority": 2,
      "segment_id": "<string>",
      "weight": 50
    }
  ],
  "assignment_config": {
    "subject": "device"
  },
  "authentication_flow": "<string>",
  "feature_flag_id": "<string>",
  "name": "<string>",
  "description": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    allocations: [
      {
        is_control: true,
        variation_id: '<string>',
        is_fallback: true,
        priority: 2,
        segment_id: '<string>',
        weight: 50
      }
    ],
    assignment_config: {subject: 'device'},
    authentication_flow: '<string>',
    feature_flag_id: '<string>',
    name: '<string>',
    description: '<string>'
  })
};

fetch('https://{tenantDomain}/api/v2/experimentation/experiments', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://{tenantDomain}/api/v2/experimentation/experiments"

	payload := strings.NewReader("{\n  \"allocations\": [\n    {\n      \"is_control\": true,\n      \"variation_id\": \"<string>\",\n      \"is_fallback\": true,\n      \"priority\": 2,\n      \"segment_id\": \"<string>\",\n      \"weight\": 50\n    }\n  ],\n  \"assignment_config\": {\n    \"subject\": \"device\"\n  },\n  \"authentication_flow\": \"<string>\",\n  \"feature_flag_id\": \"<string>\",\n  \"name\": \"<string>\",\n  \"description\": \"<string>\"\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "allocations": [
    {
      "is_control": true,
      "is_fallback": true,
      "priority": 123,
      "segment_id": "<string>",
      "variation_id": "<string>",
      "weight": 123
    }
  ],
  "assignment_config": {
    "subject": "device"
  },
  "authentication_flow": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "feature_flag_id": "<string>",
  "id": "<string>",
  "is_valid": true,
  "name": "<string>",
  "updated_at": "2023-11-07T05:31:56Z",
  "description": "<string>",
  "ended_at": "2023-11-07T05:31:56Z",
  "started_at": "2023-11-07T05:31:56Z"
}

承認

Authorization

string

header

必須

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

ボディ

トラフィック割り当てを含む実験を作成

allocation_strategy

enum<string>

必須

この実験のトラフィック割り当て戦略

利用可能なオプション:

percentage,

segment

allocations

object[]

必須

variation を重みまたはセグメントに対応付けるトラフィック割り当て

Minimum array length: 1

Show child attributes

assignment_config

object

必須

ユーザーを variation に割り当てる方法の設定

Show child attributes

authentication_flow

string

必須

この実験が適用される認証フロー

feature_flag_id

string

必須

この実験の基となる機能フラグの ID

Pattern: ^flg_[A-HJ-NP-Za-km-z1-9]+$

name

string

必須

実験のわかりやすい名前

Required string length: 3 - 255

Pattern: ^(?!.*\x00)\S(.*\S)?$

description

string

実験の説明

Required string length: 3 - 1024

Pattern: ^(?!.*\x00)\S(.*\S)?$

レスポンス

実験が正常に作成されました。

allocation_strategy

enum<string>

必須

利用可能なオプション:

percentage,

segment

allocations

object[]

必須

Show child attributes

assignment_config

object

必須

Show child attributes

authentication_flow

string

必須

created_at

string<date-time>

必須

feature_flag_id

string

必須

string

必須

Pattern: ^exp_[A-HJ-NP-Za-km-z1-9]+$

is_valid

boolean

必須

name

string

必須

status

enum<string>

必須

statusで絞り込みます。完全一致です。

利用可能なオプション:

draft,

active,

paused,

completed,

archived

updated_at

string<date-time>

必須

description

string

ended_at

string<date-time>

started_at

string<date-time>