Content Management with the ArcGIS (Online) API for Python

Download arcgis_api_overview.png and managers.txt

Learn exactly how to access ArcGIS Online using the ArcGIS API for Python and the GIS class. In this step-by-step tutorial, you’ll explore multiple authentication methods including anonymous access, built-in accounts, Pro and home strings, and secure profile-based logins so you can confidently connect to your organization’s ArcGIS Online and start automating workflows. Accessing ArcGIS Online is the first line of code when using the ArcGIS API for Python! Whether you're building standalone scripts, working inside ArcGIS Online Notebooks, or presenting Python workflows, this video shows the best practices for logging in safely and efficiently.

What you’ll learn:

• How the GIS class connects you to ArcGIS Online

• Anonymous access vs. organization-level access

• Using home/pro strings from ArcGIS Pro

• Secure login with profiles (recommended method)

• Where your encrypted credentials are stored

THIS VIDEO COVERS IMPORTANT COURSE MATERIAL

Learn how to add a Shapefile as a content item in ArcGIS Online using the ArcGIS API for Python. In this step-by-step tutorial, you'll discover how to access ArcGIS Online, work with folders, define item properties, and upload a zipped Shapefile programmatically using the Folder.add() method.

In this video you will learn how to:

• Retrieve folder objects using the ContentManager.folders.get() method.

• Create item metadata using the ItemProperties data class.

• Use the ItemTypeEnum class to define content item types safely.

• Upload zipped Shapefiles as content items using the Folder.add() method.

THIS VIDEO COVERS IMPORTANT COURSE MATERIAL

In this tutorial, you'll learn how to publish a hosted feature service in ArcGIS Online from a shapefile using the ArcGIS API for Python. Follow along as we upload shapefile content items, use the Item.publish() method, configure publish parameters, and explore how ArcGIS Online creates hosted feature layers from source data.

In this video you will learn how to:

• Use the Item.publish() method in the ArcGIS API for Python to publish a shapefile as a hosted feature service.

• Use the publish_parameters argument to customize hosted feature service publishing.

• Publish zipped shapefiles containing multiple feature classes into multi-layer hosted feature services.

THIS VIDEO COVERS IMPORTANT COURSE MATERIAL

Learn how to add a CSV file to ArcGIS Online and publish it as either a hosted table service or a hosted feature service using the ArcGIS API for Python. In this practical tutorial, you'll work with CSV publish parameters to publish tabular data as a hosted table, then use longitude and latitude fields to create a hosted point feature service in ArcGIS Online.

In this video you will learn how to:

• Add a CSV file to ArcGIS Online with Python

• Use publish() and CSV publish parameters

• Publish CSV data as a hosted point feature service

• Use latitude and longitude fields to create point features

Learn how to create folders in ArcGIS Online using the ArcGIS API for Python. In this practical tutorial, you'll use the GIS class, ContentManager, and folders.create() method to programmatically create folders in ArcGIS Online. You'll also see how to handle existing folders with the exist_ok parameter and how administrators can create folders for specific users in an ArcGIS Online organization.

In this video you will learn how to:

• Access the ArcGIS Online Content Manager

• Create folders using the ArcGIS API for Python

• Use the exist_ok parameter

• Create folders for a specific owner

Learn how to move content items into folders in ArcGIS Online using the ArcGIS API for Python. In this step-by-step tutorial, you'll use the Item.move() method to organize your ArcGIS Online content, move individual and multiple items into folders, and explore current API limitations when moving items back to the root folder.

In this video you will learn how to:

• Move a single content item into a folder

• Move multiple ArcGIS Online items programmatically

• Retrieve and use Folder objects

Learn how to list folders in ArcGIS Online using the ArcGIS API for Python. In this step-by-step tutorial, you'll discover multiple ways to retrieve folder information, work with Folder objects, and generate lists of folder names for the logged-in user or other users in your ArcGIS Online organization.

In this video you will learn how to:

• Retrieve the logged-in user's folders

• Use the User.folders property

• Use the Folders.list() method

• Extract folder names with Python list comprehension

• List folders for another user in your ArcGIS Online organization

Learn how to work with the Folder object in ArcGIS Online using the ArcGIS API for Python. In this hands-on tutorial, you'll explore folder properties, rename and delete folders, and list the content items stored within them to better automate content management workflows.

In this video you will learn how to:

• Retrieve a Folder object and access its properties

• Rename folders programmatically

• Delete & folder and what happens top the content items

• List content items stored in a folder

In this video we will create two Groups using the create() function from the GroupManager module, one using the two required parameters; title and tags, and a second Group using some optional parameters. The optional parameters available are listed and discussed.

In this video we will access the properties associated with a Group object.

An Item object has a share function that can be used to share the Item into a Group, we will share an individual item to a Group and then share all items from a specified folder into a Group.

In this video we will unshare a content item from a Group

In the Access a Group Item and View Properties video we printed the properties to screen, in this video we will look at updating some properties and show the updates in ArcGIS Online

In this lesson we will take a look at the add() method available from the SharingGroupManager to add an item into a Group. The SharingManager is a property of the Item object via the sharing property, which provides access to the SharingGroupManager via the SharingManager group property. Makes sense? Watch the video for more clarity.

NOTE: The Item object share() method is deprecated in 2.3.0 and removed in 3.0.0. The video shows the new age for sharing items into a group.

Prevent a Group from being accidentally deleted.

In this lesson we will take a look at the remove() method available from the SharingGroupManager to remove an item from a Group. The SharingManager is a property of the Item object via the sharing property, which provides access to the SharingGroupManager via the SharingManager group property. Makes sense? Watch the video for more clarity.

NOTE: The Item object unshare() method is deprecated in 2.3.0 and removed in 3.0.0. The video shows the new age for unsharing items into a group.

The get_member() method for a Group object returns a dictionary detailing the usernames of the Group owner, users, and admins.

The user_list() mthod for a Group object returns a dictionary with information about the Group owner and the users. It returns more detailed information about each user than the simple usernames returned in the get_members() method.

The notify() method for a Group object allows you to send notifications and emails to members of the Group.

The delete() method for a Group object can be used to delete a Group permanently. This does not delete content items from AGOL, these are still available. What happens if you call the delete() method on a Group that has delete protection enabled?

In this video we will access an Item objects properties for a Feature Service and print to screen.

We will update an Item object's properties and show the updated properties in ArcGIS Online

The add_comment() method for an Item object allows you to add a comment to the item's page on ArcGIS Online if comments are enabled for the item.

The protect() method for an Item object allows you to prevent the Item from accidentally being deleted.

The update_thumbnail() method enables you to add a thumbnail for an item of content.

The export() method for an Item object allows you to export from a Hosted Service and create a content item as various types such as a Shapefile in this example.

You can use the download() method for an Item object to download data to disk. You would use the export() and download() methods together to achieve successful download of data.

The usage() methods enables you to access the usage metrics for an Item.

In this lesson we will look at sharing content publicly, within the organization, and with the owner of the Item.

Note: as of 2.3.0 the item object share() method is deprecated, and removed as of 3.0.0. There is a new item object sharing property that accesses a SharingManager to provide users the ability to control how an item is shared.

As of version 2.3.0 the API introduced the SharingManager along with the SharingLevel class. We will take a look at both of these in this lesson. The SharingManager is accessed via the Item object.

Note: the SharingManager replaces the Item object share() method with is deprecated as of 2.3.0 and removed as of 3.0.0

In this lesson we will take a look at the Item object copy() method. We will focus on copying Feature Services. There is a catch with the copy() method, it does not create a standalone hosted Feature Service as the copy, but a reference back to the original it was copied from.

In this lesson we will take a look at the copy_feature_layer_collection() method available with an Item object that represents a Feature Service. Unlike the copy() method, the copy_feature_layer_collection() method creates a standalone hosted Feature Services, but, it does not copy data, it only creates the layers using the same schema without any records.

In this lesson we will take at the copy_item() method available with the Item object. The copy_item() is quite similar to the copy() method with hosted feature services in that it produces a shallow copy referencing back to the original data. Any edits in one are reflected in the other.

In this video we will access an Item as a Feature Layer Collection object, which represents a Hosted Feature Service, and print the properties to screen.

We will look at updating a selection of Feature Layer Collection properties.

In this video we will look at updating the capabilities that can be set for a Feature Layer Collection such as Edit, Update, and Delete.

With Editing capabilities set, you can enable Editor Tracking for each Feature Layer in the Feature Layer Collection