Skip To Content

Import code snippets

Description

The import operation adds code snippets from an input file to a notebook code snippet library. This operation can either add only the code snippets that do not currently exist in the library or overwrite all code snippets in the library with the code snippets from the input file.

Request parameters

ParameterDetails
itemId

(Required)

The item ID (GUID) of the notebook code snippet library where the code snippets will be imported.

file

(Required)

A zipped file containing *.py files of code snippets.

The following is an example of the format for the *.py file:

snippet_properties = {
"notebookRuntimeName": "ArcGIS Notebook Python 3 Standard",
"lastUpdated": "",
"deprecated": False,
"name": "Check remaining credits (ArcGIS Online only)",
"description": "Checks the remaining credits of an ArcGIS Online organization. The GIS must be an administrator instance.",
"language": "Python",
"snippetLibrary": "GIS Administration",
"tags": "arcgis, agol, credits, admin",
"notebookRuntimeVersion": "9.0"
}

##### SNIPPET BEGIN #####
from arcgis.gis import GIS

def check_org_credits_agol(gis: GIS) -> None:
if "admin" in gis.__dict__:
credits = gis.admin.credits.credits
print(f"This ArcGIS Online organization has {credits} credits.")
else:
print("Please connect to the ArcGIS Online organization as an administrator to check credits.")

# check_org_credits_agol(GIS)
##### SNIPPET END #####
overwrite

(Required)

A Boolean that specifies whether existing code snippets in the snippet library will be removed (overwritten), and all code snippets in the input file will be imported (true).

When set to false, only the code snippets in the input file that do not already exist in the library will be imported.

Values: true|false

f

The response format. The default response format is html.

Values: html | json | pjson

Example usage

https://<notebookserveradmin>/notebooks/snippets/import
itemId = 3fe64164ea484f008ce873c780426ac9
file = (binary)
overwrite = false
f = pjson

JSON Response syntax

{"message": "<message>"}

JSON Response example

{"message": "Code snippet(s) imported successfully."}