Remove Tag From Multiple Views

Disassociates the specified tag from a list of views, or (when `dissociateAll = true`) from all views in the workspace that are currently tagged with it.

REQUEST URI

https://<ZohoAnalytics_Server_URI>/restapi/v2/workspaces/<workspace-id>/tags/<tag-id>/views

Delete

oauthscope: ZohoAnalytics.modeling.delete

QUERY PARAMETERS

Parameter Name	Description
CONFIG^*	JSONObject Config parameter specifications are available in the below section.

FIELDS FOR CONFIG JSON

Key	Description
viewIds *	JSONArray of long List of view ids from which the tag should be removed. Conditional – Required when dissociateAll is false/absent. Array size 1 – 1000. Each element must be a view id belonging to .
dissociateAll	Boolean When true, the tag is removed from every view in the workspace that is currently associated with it. In this mode viewIds is ignored. true / false. Default false.

Sample Request:

Curl Csharp Go Java PHP Python Node JS Deluge Ruby

Copiedcurl https://analyticsapi.zoho.com/restapi/v2/workspaces/<workspace-id>/tags/<tag-id>/views --data-urlencode 'CONFIG={"viewIds":[20000000000000,20000000000001]}'
-X 'DELETE'
-H 'ZANALYTICS-ORGID: <org-id>'
-H 'Authorization: Zoho-oauthtoken <access_token>'

Copiedusing System;
using System.Collections.Generic;
using ZohoAnalytics;
using System.Text.Json;

namespace ZohoAnalyticsTest
{
    class Program
    {
        long orgId = 55522777;
        long workspaceId = 10000000000000;
        long viewId = 20000000000000;

        public void RemoveTagFromViews(IAnalyticsClient ac)
        {
            long tagId = 30000000000000L;
            List<long> viewIds = new List<long> { 20000000000000L, 20000000000001L };
            IWorkspaceAPI workspace = ac.GetWorkspaceInstance(orgId, workspaceId);
            workspace.RemoveTagFromViews(tagId, viewIds, false, null);
            Console.WriteLine("success");
        }

        static void Main(string[] args)
        {
            string clientId = "1000.xxxxxxx";
            string clientSecret = "xxxxxxx";
            string refreshToken = "1000.xxxxxxx.xxxxxxx";

            try
            {
                IAnalyticsClient ac = new AnalyticsClient(clientId, clientSecret, refreshToken);
                Program obj = new Program();
                obj.RemoveTagFromViews(ac);
            }
            catch (ServerException ex)
            {
                Console.WriteLine("Server exception - " + ex.GetErrorMessage());
            }
            catch (Exception ex)
            {
                Console.WriteLine("Other exception - " + ex.Message);
            }
        }
    }
}

Copiedpackage main

import (
    "fmt"
    ZAnalytics "zoho/pkg/analyticsclient"
)

var (
    clientId     = "1000.xxxxxxx"
    clientSecret = "xxxxxxx"
    refreshToken = "1000.xxxxxxx.xxxxxxx"

    orgId       = "55522777"
    workspaceId = "10000000000000"
    viewId      = "20000000000000"
)


func RemoveTagFromViews(ac ZAnalytics.Client) {
    tagId := "30000000000000"
    viewIds := []string{"20000000000000", "20000000000001"}
    workspace := ZAnalytics.GetWorkspaceInstance(&ac, orgId, workspaceId)
    exception := workspace.RemoveTagFromViews(tagId, viewIds, false, nil)
    if exception != nil {
        fmt.Println("Error:", exception)
        return
    }
    fmt.Println("success")
}

func main() {
    ac := ZAnalytics.GetAnalyticsClient(clientId, clientSecret, refreshToken)
    RemoveTagFromViews(ac)
}

Copiedimport com.zoho.analytics.client.*;
import org.json.*;

public class Test {

    private long orgId = 55522777l;
    private long workspaceId = 10000000000000l;
    private long viewId = 20000000000000l;

    public static void main(String args[]) {

        String clientId = "1000.xxxxxxx";
        String clientSecret = "xxxxxxx";
        String refreshToken = "1000.xxxxxxx.xxxxxxx";

        Test tObj = new Test();
        AnalyticsClient ac = new AnalyticsClient(clientId, clientSecret, refreshToken);

        try {
            tObj.removeTagFromViews(ac);
        }
        catch (ServerException ex) {
            System.out.println("Server exception - ErrorCode : " + ex.getErrorCode() + ", ErrorMessage : " + ex.getErrorMessage());
        }
        catch (ParseException ex) {
            System.out.println("Parser exception - ErrorMessage : " + ex.getResponseMessage());
        }
        catch (Exception ex) {
            System.out.println("Other exception - ");
            ex.printStackTrace();
        }
    }

    public void removeTagFromViews(AnalyticsClient ac) throws Exception {
        long tagId = 30000000000000l;
        JSONArray viewIds = new JSONArray();
        viewIds.put(20000000000000l);
        viewIds.put(20000000000001l);
        WorkspaceAPI workspace = ac.getWorkspaceInstance(orgId, workspaceId);
        workspace.removeTagFromViews(tagId, viewIds, false, null);
        System.out.println("success");
    }

}

Copied<?php

    require 'AnalyticsClient.php';

    class Test
    {
        public $ac = NULL;
        public $client_id = "1000.xxxxxxx";
        public $client_secret = "xxxxxxx";
        public $refresh_token = "1000.xxxxxxx.xxxxxxx";

        public $org_id = "55522777";
        public $workspace_id = "10000000000000";
        public $view_id = "20000000000000";

        function __construct() {
            $this->ac = new AnalyticsClient($this->client_id, $this->client_secret, $this->refresh_token);
        }

        function removeTagFromViews() {
            $tag_id = "30000000000000";
            $view_ids = array("20000000000000", "20000000000001");
            $workspace = $this->ac->getWorkspaceInstance($this->org_id, $this->workspace_id);
            $workspace->removeTagFromViews($tag_id, $view_ids, false);
            echo "success\n";
        }

    }

    $test_obj = new Test();

    try {
        $test_obj->removeTagFromViews();
    }
    catch(ServerException $se) {
        echo "Server exception : " . $se->getErrorMessage() . "\n";
    }
    catch(IOException $ioe) {
        echo "IO exception : " . $ioe->getErrorMessage() . "\n";
    }
    catch(ParseException $pe) {
        echo "Parser exception : " . $pe->getErrorMessage() . "\n";
    }
    catch(Exception $e) {
        echo "Exception : " . $e->getErrorMessage() . "\n";
    }
?>

Copiedfrom __future__ import with_statement
from AnalyticsClient import AnalyticsClient
import sys
import json

class Config:

    CLIENTID = "1000.xxxxxxx"
    CLIENTSECRET = "xxxxxxx"
    REFRESHTOKEN = "1000.xxxxxxx.xxxxxxx"

    ORGID = "55522777"
    WORKSPACEID = "10000000000000"
    VIEWID = "20000000000000"

class sample:

    ac = AnalyticsClient(Config.CLIENTID, Config.CLIENTSECRET, Config.REFRESHTOKEN)

    def remove_tag_from_views(self, ac):
        tag_id = "30000000000000"
        view_ids = ["20000000000000", "20000000000001"]
        workspace = ac.get_workspace_instance(Config.ORGID, Config.WORKSPACEID)
        workspace.remove_tag_from_views(tag_id, view_ids)
        print("success")

try:
    obj = sample()
    obj.remove_tag_from_views(obj.ac)

except Exception as e:
    print(str(e))

Copiedvar analyticsClient = require('./AnalyticsClient');

var clientId = '1000.xxxxxxx';
var clientSecret = 'xxxxxxx';
var refreshtoken = '1000.xxxxxxx.xxxxxxx';
var orgId = '55522777';
var workspaceId = '10000000000000';
var viewId = '20000000000000';

var ac = new analyticsClient(clientId, clientSecret, refreshtoken);

var tagId = '30000000000000';
var viewIds = ['20000000000000', '20000000000001'];
var workspace = ac.getWorkspaceInstance(orgId, workspaceId);
workspace.removeTagFromViews(tagId, viewIds, false).then(() => {
    console.log('success');
}).catch((error) => {
    console.log('errorCode : ' + error.errorCode);
    console.log('errorMessage : ' + error.errorMessage);
});

CopiedorgId = "55522777";
workspaceId = "10000000000000";
tagId = "30000000000000";

headersMap = Map();
headersMap.put("ZANALYTICS-ORGID", orgId);

viewIds = List();
viewIds.add(20000000000000);
viewIds.add(20000000000001);

config = Map();
config.put("viewIds", viewIds);

paramsMap = Map();
paramsMap.put("CONFIG", config.toString());

response = invokeurl
[
  url :"https://analyticsapi.zoho.com/restapi/v2/workspaces/" + workspaceId + "/tags/" + tagId + "/views"
  type :DELETE
  parameters:paramsMap
  headers:headersMap
  connection:"analytics_oauth_connection"
];
info response;

Copiedrequire 'zoho_analytics_client'

class Config
  ORGID = "55522777"
  WORKSPACEID = "10000000000000"
  VIEWID = "20000000000000"
end

class Sample
  def initialize
    @ac = AnalyticsClient.new
           .with_data_center("US")
           .with_oauth({
             "clientId" => "1000.xxxxxxx",
             "clientSecret" => "xxxxxxx",
             "refreshToken" => "1000.xxxxxxx.xxxxxxx"
           })
           #.with_token_store_path("/home/admin/analytics_ruby_sdk/tokens") # Optional – specify a directory path to securely store the encrypted access token
           .build
  end

  def remove_tag_from_views
    tag_id = "30000000000000"
    view_ids = ["20000000000000", "20000000000001"]
    workspace = @ac.get_workspace_instance(Config::ORGID, Config::WORKSPACEID)
    workspace.remove_tag_from_views(tag_id, view_ids, false)
    puts "success"
  end

end

begin
  obj = Sample.new
  obj.remove_tag_from_views
rescue ServerError => e
  puts "Server Error: #{e.response_content}"
rescue StandardError => e
  puts e.message
  puts e.backtrace.join("\n")
end

Sample value for CONFIG parameter

CopiedRemoving the tag from a specific set of views:

{
  "viewIds": [
    466206000000061002,
    466206000000061003
  ]
}

Removing the tag from all views it is currently associated with:

{
  "dissociateAll": true
}

Sample Response:

CopiedHTTP/1.1 204 No Content