Clarify what "generation" does in the File.acl method #349

Activity

1. jgeewax

   added

   enhancement

   docs

   on Jan 15, 2015
2. ryanseys commented on Jan 18, 2015

   

   ryanseys

   on Jan 18, 2015

   Contributor

   More actions

   Isn't a description of the generation parameter seen here sufficient?

   Excerpt:

   @param {int=} options.generation - **File Objects Only** Select a specific revision of this file (as opposed to the latest version, the default).

   Or would you like a better-described code example?
3. jgeewax commented on Jan 20, 2015

   

   jgeewax

   on Jan 20, 2015

   ContributorAuthor

   More actions

   I think that covers it if we're looking at the parameter, but since we're giving an example, we should include more detail:

   /*
    * For file ACL operations, you can also specify a `generation` property 
    * to control access on a specific revision of a file.
    */
4. stephenplusplus

   closed this as completedin #358on Jan 20, 2015
5. jgeewax

   added this to the Storage Stable milestone on Feb 2, 2015
6. jgeewax

   added

   api: storageIssues related to the Cloud Storage API.Issues related to the Cloud Storage API.

   on Feb 2, 2015
7. yoshi-automation

   added

   triage meI really want to be triaged.I really want to be triaged.

   🚨This issue needs some love.This issue needs some love.

   on Apr 6, 2020
8. JustinBeckwith

   assigned

   stephenplusplus

   on Feb 1, 2021
9. chingor13

   added a commit that references this issue on Aug 22, 2022

   feat: add v1p5beta1 API surface (#349)

   128081a
10. sofisl

    added a commit that references this issue on Sep 16, 2022

    chore: release 3.1.0 (#349)

    c9c35b4
11. sofisl

    added a commit that references this issue on Sep 27, 2022

    chore: remove extra API from pretty name (#349)

    ...

    13a53db
12. sofisl

    added 2 commits that reference this issue on Oct 5, 2022

    chore: release 3.1.0 (#349)

    b1ff865

    chore: release 3.1.0 (#349)

    1aac553
13. 33 remaining items

    Load more
14. GautamSharda

    added a commit that references this issue on Feb 3, 2026

    fix(middleware): need message in request log message (#349)

    c4baf78
15. sofisl

    added a commit that references this issue on Feb 4, 2026

    chore: release 1.2.3 (#349)

    b1a663c
16. GautamSharda

    added a commit that references this issue on Feb 5, 2026

    build!: upgrade engines field to >=8.10.0 (#349)

    f5c4393
17. sofisl

    added

    library: cloud-profilerIssues transferred from another repositoryIssues transferred from another repository

    on Feb 7, 2026
18. GautamSharda

    added 2 commits that reference this issue on Feb 23, 2026

    build!: upgrade engines field to >=8.10.0 (#349)

    482e733

    build!: upgrade engines field to >=8.10.0 (#349)

    4ba6c0f
19. sofisl

    added 3 commits that reference this issue on Feb 26, 2026

    chore: make sure workloadb benchmark runs properly (#349)

    f761fdb

    chore: migrate code from googleapis/gcp-metadata (#53)

    ...

    fa9a454

    chore(deps): update dependency sinon to v11 (#349)

    ...

    3cd764f
20. GautamSharda

    added 2 commits that reference this issue on Mar 11, 2026

    chore(deps): update dependency @types/sinon to v5.0.7 (#349)

    04d8baf

    feat: allow options to ServiceObject methods (#349)

    9fa14e0
21. GautamSharda

    added 2 commits that reference this issue on Mar 23, 2026

    chore: include build in eslintignore (#349)

    83b410a

    chore: include build in eslintignore (#349)

    ed46bfb
22. shivanee-p

    added a commit that references this issue on Mar 27, 2026

    chore: include build in eslintignore (#349)

    00ceaf7
23. thiyaguk09

    added a commit that references this issue on May 5, 2026

    chore: include build in eslintignore (googleapis#349)

    dfb012f