在 PHP 中使用 Google API 在 Google 文档中添加文本时了解范围

Question

我想在 Google Doc 上添加文本，但与“范围”参数混淆。我想了解在向任何 Google 文档添加文本时“范围”参数的作用。我将始终仅在文档顶部添加文本，因此请指导我哪里做错了。此外，我还将针对某些文本添加复选框。以下是我当前用于添加文本然后添加复选框的代码：

$requests[] = new \Google_Service_Docs_Request(
        array(
            'insertText' => array(
                'text' => 'abcdtrig',
                'location' => array(
                    'index' => 10),
            ),
        )
    );

    $requests[] = new \Google_Service_Docs_Request(
        array(
            'createParagraphBullets' => array(
                'range' => array(
                    'startIndex' => 1,
                    'endIndex' => 25
                ),
                'bulletPreset' => 'BULLET_CHECKBOX'
            ),
        )
    );

    $requests[] = new \Google_Service_Docs_Request(
        array(
            'deleteParagraphBullets' => array(
                'range' => array(
                    'startIndex' => 1,
                    'endIndex' => 2
                )
            ),
        )
    );

    $requests[] = new \Google_Service_Docs_Request(
        array(
            'insertText' => array(
                'text' => '#milk',
                'location' => array(
                    'index' => 1),
            ),
        )
    );


    $batchUpdateRequest = new \Google_Service_Docs_BatchUpdateDocumentRequest(array(
        'requests' => $requests
    ));

我希望它的工作方式是每当我运行此脚本时，它都应该在文档顶部添加文本，并且文档的现有内容将向下移动。

请帮助我理解范围的概念，因为其他事情运行良好，我对此很清楚。只需要理解“范围”的概念即可。